メインコンテンツまでスキップ

保存したクエリへのアクセスと管理

この記事では、Databricks UI を使用してクエリにアクセスし、管理する方法について説明します。

クエリを表示する​

クエリは、次の方法で表示できます。

  • ワークスペースアイコンサイドバーの「 ワークスペース 」をクリックします。 クエリは、デフォルトでは ホーム フォルダで表示可能です。 ユーザーは、クエリをワークスペースブラウザー内のフォルダーに、他の Databricks オブジェクトと共に整理できます。
  • サイドバーの「クエリーアイコン クエリ 」をクリックします。 [クエリ] ウィンドウのオブジェクトは、デフォルトでは時系列の逆順に並べ替えられます。リストを並べ替えるには、[ 作成日] 列見出しをクリックします。 [ フィルター クエリ ] テキスト ボックスに入力して、名前、タグ、または所有者でフィルター処理します。

ワークスペース ブラウザーでクエリをフォルダーに整理する​

クエリは、 ワークスペース ブラウザー やその他の Databricks オブジェクトのフォルダーに整理できます。 「ワークスペース ブラウザー」を参照してください。

クエリの所有権を譲渡する​

クエリの所有権を移行するには、ワークスペース管理者である必要があります。 サービスプリンシパル と グループ にクエリの所有権を割り当てることはできません。 Permissions API を使用して所有権を譲渡することもできます。

  1. ワークスペース管理者として、Databricksワークスペースにログインします。

  2. サイドバーで、「 クエリ 」をクリックします。

  3. クエリをクリックします。

  4. 右上の 「共有 」ボタンをクリックして、「 共有 」ダイアログを開きます。

  5. 右上の歯車アイコンをクリックし、「 新規所有者を割り当て 」をクリックします。

    新規所有者を割り当て

  6. 所有権を割り当てるユーザーを選択してください。

  7. 確認 をクリックします。

クエリのアクセス許可を構成する​

ワークスペース管理者とクエリ作成者には、クエリを管理および実行できるユーザーを制御するためのアクセス許可が自動的に付与されます。 クエリを共有するには、少なくともクエリに対する CAN MANAGE 権限が必要です。

クエリでは、次の 2 種類の共有設定がサポートされています。

  • 実行 as viewer : ビューアーの資格情報を使用して実行クエリを実行します。また、閲覧者は、ウェアハウスに対する少なくとも CAN USE 権限を持っている必要があります。従来の SQL エディターでは、共有設定が [ビューアーとして実行] に設定されている場合にのみ、ユーザーに CAN EDIT アクセス許可を付与できます。
  • 所有者として実行 : 新しい SQL エディターでは、所有者の資格情報がレガシーアラート、 LakeFlow ジョブ、およびレガシーダッシュボードに使用されます。 ビューアーの資格情報は、クエリの実行に常に使用されます。従来の SQL エディターでは、所有者の資格情報を使用してクエリを実行します。

クエリのアクセス許可レベルの詳細については、「 クエリ ACL」を参照してください。

  1. サイドバーで、「 クエリ 」をクリックします。

  2. クエリをクリックします。

  3. 右上の 共有ボタン ボタンをクリックして、[ 共有 ]ダイアログを開きます。

    クエリの権限を管理します

  4. 付与したい権限の種類に応じて、手順に従ってください。

  5. グループとユーザーを検索して選択し、権限レベルを割り当てます。

  6. [ 追加 ] をクリックします。

  7. 下部 > [共有設定] の [資格情報 ] フィールドで、[ 閲覧者として実行 ] または [ 所有者として実行 ] を選択します。

[共有] ダイアログでクエリへのリンクをコピーすることもできます。

すべてのクエリに対する管理者アクセス​

Databricks ワークスペース管理者ユーザーは、ワークスペース内のすべてのクエリに対する表示アクセス権を持っています。 [すべてのクエリ] タブが選択されている場合、ワークスペース管理者はクエリを表示および削除できます。ただし、共有設定の資格情報が [ 所有者として実行 ] に設定されている場合、ワークスペース管理者はクエリを編集できません。

すべてのクエリを表示するには：

  1. サイドバーの「クエリーアイコン クエリ 」をクリックします。
  2. 画面の上部付近にある [すべてのクエリ ] タブをクリックします。

他の環境でのクエリの作成​

Databricks UI を使用せずに、Rest API、JDBC/ODBC コネクタ、またはパートナー ツールを使用してクエリを作成できます。

SQLコマンドを実行し、Databricksのデータベースオブジェクトを参照するために、SQLコネクタ、ライブラリ、ドライバー、API、およびツールを参照してください。

Databricks Terraform プロバイダーと databricks_sql_query を使用してクエリを作成することもできます。

Partner Connectを通じて使用できるパートナーツールについては、「技術パートナー 」を参照してください。

に最終更新