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

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

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

クエリを表示する

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

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

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

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

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

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

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

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

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

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

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

    新規所有者を割り当て

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

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

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

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

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

  • ビューアとして実行 : ビューアの資格情報は、クエリの実行に使用されます。 また、ビューアーには、ウェアハウスに対する少なくとも CAN USE アクセス許可も必要です。 ユーザーに CAN EDIT 権限を付与できるのは、共有設定が [閲覧者として実行 ] に設定されている場合のみです。
  • 所有者として実行 : 所有者の資格情報は、クエリの実行に使用されます。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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