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

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

クエリの表示

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

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

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

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

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

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

ワークスペース管理者として、Databricks ワークスペースにログインします。
サイドバーで [ クエリ] をクリックします。
クエリをクリックします。
右上の「共有」ボタンをクリックして、「共有」ダイアログを開きます。
右上の歯車アイコンをクリックし、[ 新しい所有者を割り当てる] をクリックします。
所有権を割り当てるユーザーを選択します。
「確認」をクリックします。

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

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

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

ビューアとして実行: ビューアの資格情報はクエリを実行するために使用されます。閲覧者には、少なくともウェアハウスに対する CAN USE 権限が必要です。

ユーザーに CAN EDIT 権限を付与できるのは、共有設定が「ビューアとして実行」に設定されている場合のみです。
所有者として実行: 所有者の資格情報はクエリを実行するために使用されます。

クエリ権限レベルの詳細については、「クエリ ACL」を参照してください。

サイドバーで [ クエリ] をクリックします。
クエリをクリックします。
右上のボタンをクリックして、[共有]ダイアログを開きます。
付与する権限のタイプに基づいてステップに従います。
グループとユーザーを検索して選択し、権限レベルを割り当てます。
「追加」をクリックします。
下部の[共有設定] > [資格情報]フィールドで、 [閲覧者として実行]または[所有者として実行]を選択します。

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

すべてのクエリへの管理者アクセス

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

すべてのクエリを表示するには、次のようにします。

サイドバーの [クエリ ] をクリックします。
画面の上部近くにある[すべてのクエリ]タブをクリックします。

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

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

「 SQL データベースツールを使用して SQL コマンドを実行し、Databricks でデータベースオブジェクトを参照する」を参照してください。

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

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