次の方法で共有

クエリ スニペット

多くの場合、最初から何かを書くよりも、前の作業を複製して変更する方が簡単です。 これは、一般的な JOIN ステートメントや複雑な CASE 式に特に当てはまります。 クエリの一覧が増えるにつれて、必要なステートメントが含まれているクエリを覚えにくい場合があります。 また、ユーザーが実行時に置き換えることができるプレースホルダー テキストを含む挿入ポイントを含むクエリ スニペットを作成することもできます。

クエリ スニペットは、オートコンプリートを使用して共有およびトリガーできるクエリのセグメントです。 次の場合にクエリ スニペットを使用します。

  • 頻繁なJOINステートメント
  • WITHやCASEなどの複雑な句。
  • 条件付き書式

スニペットの例を次に示します。

--Simple snippet
WHERE fare_amount > 100

--Snippet with an insertion point for a value to be provided at runtime
WHERE fare_amount > ${1:value}

--Snippet with an insertion point for a value to be provided at runtime and containing a default value
WHERE fare_amount > ${1:100}

--Snippet with multiple insertion points
WHERE fare_amount > ${2:min_value} AND fare_amount < ${1:max_value} AND trip_distance < ${0:max_distance}

クエリ スニペットを作成する

クエリ スニペットは、SQL、ノートブック、またはファイル エディターから作成できます。 次の手順に従います。

  1. SQL エディターで、 Kebab メニュー アイコン をクリックします。kebab メニュー。

    新しい SQL エディターで、Kebab メニュー アイコンをクリックします。kebab メニューをクリックし、[表示] をクリックします。

    ノートブックまたはファイル エディターで、[ 表示] をクリックします。

  2. クエリスニペット をクリックします。

  3. [ クエリ スニペットの作成] をクリックします。

  4. [ 置換 ] フィールドにスニペット名を入力します。 この名前は、スニペットを使用するクエリを記述するときに使用します。

  5. (オプション) 説明を入力します。

  6. [ スニペット ] フィールドにスニペットを入力します。

  7. Create をクリックしてください。

    クエリ スニペット

クエリ スニペットを使用する

クエリ スニペットは、任意の SQL クエリを使用できます。 クエリ スニペットには、SQL エディター、ノートブック SQL セル、SQL ファイル、AI/BI ダッシュボード クエリでアクセスできます。

これらのクエリ スニペットを使用できる単純なクエリの例を次に示します。

--Simple query
SELECT * FROM samples.nyctaxi.trips

このクエリでクエリ スニペットを使用するには、次の手順に従います。

  1. SQL エディターを開きます。

  2. SQL エディターのクエリ ペインにクエリを入力します。

  3. クエリ スニペットの名前の入力を開始し、オートコンプリート ウィンドウから選択します。

    SQL エディターでは、 Control+Space を使用してウィンドウを手動で開き、スニペットを選択することもできます。

    スニペットを選択するクエリ

  4. クエリ スニペットから WHERE 句を使用してクエリを実行します。

    クエリで使用されるスニペットを示すクエリ

クエリ スニペットでの挿入ポイントの操作

挿入ポイントを指定するには、単一のドル記号と波括弧で整数のタブオーダーを括ります。 テキスト プレースホルダー:はコロンの後に置くことができますが、それはスニペットに慣れていないユーザーにとって役立ちます。 前に作成した挿入ポイントを含むクエリ スニペットでは、 ${1:value} はプレースホルダーを持つ挿入ポイントであり、 ${1:100} は、実行時にオーバーライドできるプレースホルダーの既定値を持つ挿入ポイントです。 Databricks SQL がスニペットをレンダリングすると、ドル記号 $ と中かっこ {} が削除され、置換のために value または既定の 100 が強調表示されます。

複数の挿入ポイントがある場合、テキスト挿入キャレットは最初の挿入ポイントにジャンプして、目的の値を求めます。 Tabを押すと、キャレットは次の値の次の挿入ポイントにジャンプします。 もう一度 Tab を押すと、キャレットは次の挿入ポイントにジャンプし、最後の挿入ポイントに達するまで移動します。

注

0 ${0} の挿入ポイントは、常にタブ オーダーの最後のポイントです。

次の手順に従って、クエリの挿入ポイントクエリスニペットを使用してください。

  1. SQL エディターを開きます。

  2. SQL エディターのクエリ ペインにクエリを入力します。

  3. クエリ スニペットの名前の最初の 3 文字を入力し、既定値のない挿入ポイントを含むクエリ スニペットを選択します。

    クエリ スニペットがクエリに追加され、テキスト挿入キャレットが挿入ポイントにジャンプします。

    既定値なしの挿入ポイント クエリ スニペットを使用したクエリ

  4. WHEREなど、200句の値を入力します。

  5. 必要に応じて、クエリ スニペットから WHERE 句を使用してクエリを実行します。

  6. 前の手順を繰り返しますが、既定値を使用して挿入ポイントを含むクエリ スニペットを選択します。

    既定値を含む挿入ポイント クエリ スニペットを使用したクエリ

  7. 前の手順を繰り返しますが、複数の挿入ポイントを含むクエリ スニペットを選択します。

    複数の挿入ポイントを含む挿入ポイント クエリ スニペットを使用したクエリ

  8. 最初の挿入ポイントの値を入力し、次の挿入ポイントにタブ移動して値を入力し、最後の挿入ポイントにタブ移動して値を入力します。