クエリ スニペット

  • [アーティクル]

多くの場合、何かをゼロから書き込むよりも、前の作業を複製して変更する方が簡単です。 これは、一般的な 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}

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

これらのスニペットの例を使用してスニペットを作成するには、次の手順に従います。

  1. ワークスペースの上部バーでユーザー名を選択し、ドロップダウンから [設定] を選択します。

  2. [開発者] タブをクリックします。

  3. SQL クエリ スニペットの横にある [管理] をクリックします。

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

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

  6. 任意で説明を入力します。

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

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

    クエリ スニペット

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

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

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

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

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

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

  3. スニペット名の最初の 3 文字を入力し、オートコンプリート ウィンドウからスニペットを選択します。 Option + Space を押してスニペットを選択すると、このウィンドウを手動で開くこともできます。

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

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

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

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

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

複数の挿入ポイントがある場合、テキスト挿入キャレットが最初の挿入ポイントにジャンプして、必要な値の入力を求めます。 Tab を押すと、キャラットは次の値の次の挿入ポイントにジャンプします。 もう一度 Tab を押すと、キャレットは次の挿入ポイント行にジャンプし、最後の挿入ポイントに達するまで続けます。

Note

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

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

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

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

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

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

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

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

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

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

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

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

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

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