新しいSQLエディターを使用した同僚との共同作業

プレビュー

この機能はパブリックプレビュー段階です。

Databricks UIのビルトインのSQLエディターが再設計され、コラボレーションを強化し、SQL開発速度を向上させる新機能が導入されました。基本的なクエリ機能とビジュアライゼーション機能の多くは、従来の SQL エディターと同じです。

この記事では、新しい SQL エディターへのアクセス方法、クエリとアクセス許可の管理方法、UI で使用できる新機能の使用方法について説明します。 クエリの作成、使用可能なデータの参照、視覚化の作成などの基本的な機能の詳細については、「 SQL エディターでのクエリの記述とデータの探索」を参照してください。

新しい SQL エディターへのアクセス

ワークスペースで新しいクエリ エディターが有効になっている場合は、カタログとスキーマのドロップダウン セレクターの右側に [新しい SQL エディター ] トグルが表示されます。 画面が狭い場合には、カタログセレクターとスキーマセレクターの右側にあるケバブメニュー をクリックすると、「 新規 SQL エディター ケバブメニュー」トグルを見つけることができます。

新しいクエリ エディターをオフにした SQL エディターを示すスクリーンショット

新しいエディタは、所有している任意のクエリに対して有効にできます。 これを行うには、次の手順を使用します。

  • [新しい SQL エディター] をクリックします。「新規 SQL エディター」ポップオーバー・メニューが開きます。

    • [ すべてのクエリに適用 ] チェックボックスはデフォルトで選択されています。 所有するすべてのクエリに対してエディターを有効にするには、この設定を保持します。

    • 新しいエディタをアクティブなクエリに対してのみ有効にするには、[ すべてのクエリに適用 ] チェックボックスをオフにします。

  • [新しい SQL エディター] トグルを [オン]に設定します。

新しい SQL エディタは、すべてのクエリに使用できるわけではありません。 次のいずれかに該当する場合、クエリの新しい SQL エディタに切り替えることはできません。

  • クエリの所有者ではない場合。

  • サポートしていない クエリベースのドロップダウンリスト または 　レンジ パラメーターのタイプがクエリに含まれている場合。 「クエリ パラメーターの操作」を参照してください。

新しい SQL エディターをオンにすると、クエリが新しい UI で再び開きます。 クエリを実行するまで、結果セットは空です。

注：

クエリ結果は、すべての共同作業者と共有されます。

クエリを共有する

新しいエディターでクエリを共有するためのアクセス許可はほとんど変更されていませんが、ライブ コラボレーションをサポートするためのいくつかの違いがあります。 「所有者として実行 」と「 ビューアーとして実行 」の資格情報の設定については、「 クエリのアクセス許可を構成する 」を参照してください。クエリオブジェクトへのアクセスを管理する方法については、「 クエリ ACL 」を参照してください。

新しい SQL エディターは、次の 2 つの部分でパーミッションを処理します。

インタラクティブな実行: 新しい SQL エディターのクエリは、常にビューアーのして実行の資格情報を使用して実行されます。 クエリ結果には、クエリにアクセスできるすべてのユーザーがアクセスできます。 CAN EDIT 以上の権限を持つユーザーは、共有クエリのドラフトを変更できます。 また、保存されていない編集内容は、CAN VIEW 権限以上の権限を持つすべてのユーザーが表示できます。 ユーザーは、クエリを実行するために、関連付けられたウェアハウスに対する少なくとも CAN USE アクセス許可を持っている必要があります。

資格情報の設定 アラート、 ワークフロー、およびレガシーダッシュボードの権限設定は、従来のSQLエディタの権限設定と同じです。 好みに応じて、これらのアセットは所有者または閲覧者の資格情報を使用して実行できます。

クエリの保存

新しい SQL エディターのクエリ コンテンツは、継続的に自動保存されます。 [保存] ボタンは、ドラフト クエリ コンテンツをレガシー ダッシュボード、ワークフロー、アラートなどの関連アセットに適用するかどうかを制御します。クエリが [所有者として実行 ] 資格情報と共有されている場合、クエリの所有者のみが [ 保存 ] ボタンを使用して変更を反映できます。 認証情報が [ビューアとして実行] に設定されている場合、少なくとも CAN MANAGE 権限を持つすべてのユーザーがクエリを保存できます。

クエリに対するリアルタイムの共同作業

複数のユーザーがクエリを編集しているGIF画像。

クエリを共有した後、共同編集を通じてクエリをライブで共同編集またはデバッグできます。 編集者は、個々のコード行にコメントして、質問をしたり、提案を追加したりすることもできます。

オリエンテーション

このセクションでは、UI の主な違いと、使用可能な機能を見つけて使用する方法について説明します。

テキストに示されているように、ラベル付きの吹き出しが付いた SQL エディターを示すスクリーンショット。

  1. ワークスペース・ファイル・システムへのアクセス: SQL エディターから直接ワークスペース・オブジェクトにアクセスして編成できます。

  2. 統合された Databricks Assistant を使用する: アシスタントとチャットして、クエリの記述、絞り込み、理解を支援します。 アシスタントによって生成されたコードをサイドパネルから実行します。

  3. コードのセクションを折りたたむ: コード ブロックの左側にある折りたたみ矢印をクリックして、コード セクションを選択的に非表示または展開します。 これにより、大きなファイルの処理が容易になります。

  4. コマンド パレットを開く: コマンド パレットには、一般的なアクション、キーボード ショートカット、カスタム テーマ、および必要なものをすばやく見つけるのに役立つリンクが含まれています。 開いたら、検索バーを使用して特定のツールとショートカットを探します。

  5. コードにコメントする: コードにコメントを追加して、コラボレーションを強化します。

  6. バージョン履歴を確認する: クエリに対する最近の変更を確認します。

すべての結果を見る

各ステートメントからの出力を複数の結果ステートメントと比較できます。 1 つの編集ウィンドウから複数の SQL 文を実行する場合は、画面下部にある [出力 ] パネルの UI を使用して、さまざまな結果セットをスクロールできます。

新しいSQLエディターを使用すると、出力パネル内のさまざまなテーブルをスクロールできます。

パラメーター構文の変更

二重中括弧 ({{}}}) を使用してパラメーターを示すクエリは、新しい SQL エディターで実行するように変更する必要があります。 新しいSQL エディターでは、Databricks AI/BIダッシュボード、AI/BIgenie 、ノートブックなどの他の ツールと同じパラメーター構文が使用されます。

新しい SQL エディターのパラメーターは、名前付きパラメーター構文を使用して定義されます。 名前付きパラメーターは、クエリ内のパラメーターで、コロンのプレフィックスが付くものです (例: :parameter_name)。

SQL 参照の資料については 、名前付きパラメーター・マーカー を参照してください。 従来のSQL エディターから名前付きパラメーター・マーカーにパラメーター構文を変換する例については、 名前付きパラメーター構文の例 を参照してください。

新しい SQL エディターを無効にする

新しい SQL エディタを無効にするには、次の手順を使用します。

  • [新しい SQL エディタ] をクリックします。「新規 SQL エディター」ポップオーバー・メニューが開きます。

  • 「新規 SQL エディタ」トグルを「オフ」に設定します。

  • 確認ダイアログで、新しいエディタをアクティブなクエリのみを無効にするか、すべての適格なクエリに対して無効にするかを選択します。

    • [すべての適格なクエリの無効化] は選択されていません。アクティブなクエリのみに対して新しいエディターを無効にする場合は、この設定をそのまま使用します。

    • すべてのクエリで新しい SQL エディタを無効にするには、 [ すべての対象クエリで無効にする] チェック ボックスをオンにします。

ワークスペース 管理者は、プレビュー ポータルにアクセスして、ワークスペース レベルでプレビューをオフにできます。 「Databricks プレビューの管理」を参照してください。