保存したクエリへのアクセスと管理
この記事では、Databricks UI を使用してクエリにアクセスし、管理する方法について説明します。
クエリを表示する
クエリは、次の方法で表示できます。
サイドバーの「 ワークスペース 」をクリックします。 クエリは、デフォルトでは ホーム フォルダで表示可能です。 ユーザーは、クエリをワークスペースブラウザー内のフォルダーに、他の Databricks オブジェクトと共に整理できます。
- サイドバーの「
クエリ 」をクリックします。 [クエリ] ウィンドウのオブジェクトは、デフォルトでは時系列の逆順に並べ替えられます。リストを並べ替えるには、[ 作成日] 列見出しをクリックします。 [ フィルター クエリ ] テキスト ボックスに入力して、名前、タグ、または所有者でフィルター処理します。
ワークスペース ブラウザーでクエリをフォルダーに整理する
クエリは、 ワークスペース ブラウザー やその他の Databricks オブジェクトのフォルダーに整理できます。 「ワークスペース ブラウザー」を参照してください。
クエリの所有権を譲渡する
クエリの所有権を移行するには、ワークスペース管理者である必要があります。 サービスプリンシパル と グループ にクエリの所有権を割り当てることはできません。 Permissions API を使用して所有権を譲渡することもできます。
-
ワークスペース管理者として、Databrickワークスペースにログインします。
-
サイドバーで、「 クエリ 」をクリックします。
-
クエリをクリックします。
-
右上の 「共有 」ボタンをクリックして、「 共有 」ダイアログを開きます。
-
右上の歯車アイコンをクリックし、「 新規所有者を割り当て 」をクリックします。
-
所有権を割り当てるユーザーを選択してください。
-
確認 をクリックします。
クエリのアクセス許可を構成する
ワークスペース管理者とクエリ作成者には、クエリを管理および実行できるユーザーを制御するためのアクセス許可が自動的に付与されます。 クエリを共有するには、少なくともクエリに対する CAN MANAGE 権限が必要です。
クエリでは、次の 2 種類の共有設定がサポートされています。
- ビューアとして実行 : ビューアの資格情報は、クエリの実行に使用されます。 また、ビューアーには、ウェアハウスに対する少なくとも CAN USE アクセス許可も必要です。 ユーザーに CAN EDIT 権限を付与できるのは、共有設定が [閲覧者として実行 ] に設定されている場合のみです。
- 所有者として実行 : 所有者の資格情報は、クエリの実行に使用されます。
クエリのアクセス許可レベルの詳細については、「 クエリ ACL」を参照してください。
-
サイドバーで、「 クエリ 」をクリックします。
-
クエリをクリックします。
-
右上の
ボタンをクリックして、[ 共有 ]ダイアログを開きます。
-
付与したい権限の種類に応じて、手順に従ってください。
-
グループとユーザーを検索して選択し、権限レベルを割り当てます。
-
[ 追加 ] をクリックします。
-
下部 > [共有設定] の [資格情報 ] フィールドで、[ 閲覧者として実行 ] または [ 所有者として実行 ] を選択します。
[共有] ダイアログでクエリへのリンクをコピーすることもできます。
すべてのクエリに対する管理者アクセス
Databricks ワークスペース管理者ユーザーは、ワークスペース内のすべてのクエリに対する表示アクセス権を持っています。 [すべてのクエリ] タブが選択されている場合、ワークスペース管理者はクエリを表示および削除できます。ただし、共有設定の資格情報が [ 所有者として実行 ] に設定されている場合、ワークスペース管理者はクエリを編集できません。
すべてのクエリを表示するには:
- サイドバーの「
クエリ 」をクリックします。
- 画面の上部付近にある [すべてのクエリ ] タブをクリックします。
他の環境でのクエリの作成
Databricks UI を使用せずに、Rest API、JDBC/ODBC コネクタ、またはパートナー ツールを使用してクエリを作成できます。
SQLコネクタ、ライブラリ、ドライバー、APIs 、および SQLコマンドを実行し、 でデータベースオブジェクトを参照するためのツールDatabricks を参照してください。
Databricks Terraform プロバイダーと databricks_sql_query を使用してクエリを作成することもできます。
を通じて使用できるパートナーツールについては、「技術パートナーPartner Connect 」を参照してください。