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