Databricksでパラメータを一元管理しましょう！

本日、SQLエディタで名前付きパラメータマーカーのサポートを発表できることを嬉しく思います。この機能により、SQLエディタでパラメータ化されたコードを記述でき、そのままダッシュボードやノートブックで構文を変更せずにコピーして実行することが可能になります。これは、クエリ、ノートブック、ダッシュボード全体でパラメータを統一するための重要なマイルストーンとなります。

名前付きパラメータマーカーを使用する

パラメータを使用することで、実行時にデータセットのクエリに値を代入し、日付や商品カテゴリなどの条件でデータをフィルタリングできます。これにより、SQLクエリでデータが集約される前に、より効率的なクエリと精度の高い分析が可能になります。

パラメータマーカーは、クエリ、ノートブック、ダッシュボード、ワークフロー、SQL Execution APIでサポートされています。これらは厳密に型指定されており、提供された値をSQL文から明確に分離することで、SQLインジェクション攻撃に対する耐性も強化されています。名前付きパラメータマーカーの構文は、アルファベット単語の先頭にコロン（:）を付けるだけで使用可能です。例えば、:parameter_nameや:`スペース付きのパラメータ`のようにします。

キーワード、例えば列名やテーブル名を指定するには、 identifier()関数をラッパーとして使用します。例えば、identifier(:parameter_name)のようにします。

既存のパラメータを名前付きパラメータマーカー構文を使用して更新することをお勧めします。近く、パラメータを自動的に変換するアシスタントアクションを提供する予定です。

一般的なユースケース

以下は、パラメータが役立ついくつかの使用例です：

特定の時間枠内のレコードを選択するためのパラメータ化された日付範囲をクエリに追加します。

動的にカタログ、スキーマ、テーブルを選択または作成します。

パラメータでクエリスキーマを定義します。

出力をフォーマットするためにテンプレート化された文字列をパラメータ化します。例えば、電話番号など。

日、月、または年ごとにロールアップをパラメータ化します。

単一のクエリで複数のパラメータ値を選択します。

近日更新予定

日付範囲と複数値のパラメータを使用して、フィールドおよびパラメータのフィルタリングをさらにシンプルかつ柔軟に行うことを期待しています。例えば、

と

名前付きパラメータマーカー構文を始めましょう

クエリ、ノートブック、ダッシュボード、ワークフロー、SQL Execution APIの名前付きパラメータマーカー構文は、今日から利用可能です。フィードバックや質問がある場合は、以下のアドレスまでお問い合わせください。sql-editor-feedback@databricks.com。詳細なリソースについては、ドキュメンテーションページをご覧ください。Databricksでのパラメータの使い方について詳しく説明しています。

Databricks SQLについて詳しく知りたい方は、私たちのウェブサイトをご覧いただくか、ドキュメンテーションをご覧ください。また、Databricks SQLのプロダクトツアーもご覧いただけます。既存のウェアハウスを高性能でサーバーレスのデータウェアハウスに移行し、優れたユーザーエクスペリエンスと低コストを実現したい場合、Databricks SQLが解決策です。 無料トライアルをぜひお試しください。