Parameterize your SQL query
Last updated
Was this helpful?
Last updated
Was this helpful?
There are times you want to dynamically update your SQL queries based on results of previous calculations or other data in your notebook. DataLab supports this through SQL parameterization, which allows you to insert variables into your SQL queries. SQL parameterization is supported in both Python and R workbooks.
To insert a simple variable into your query, wrap it in double curly braces ({{ }}
):
To insert an array in a WHERE ... IN
statement, you can use theinclause
filter:
To insert a simple variable into your query, wrap it in double curly braces ({{ }}
):
To insert an array in a WHERE ... IN
statement, DataLab provides the join()
function:
Alternatively, you can choose to preprocess in R yourself and inject a string, like so:
DataLab uses to process your SQL queries and thus supports all Jinja syntax.
We use to ensure you cannot accidentally inject malicious code in your SQL query. If you want to escape this safety, use the sqlsafe
filter to mark your parameter as safe:
DataLab uses to process your SQL queries and thus supports most Jinja syntax in R.
Unlike for Python, DataLab can't protect against in interpolated SQL queries, so parametrize your queries with care.