Google
Cloud Platform
Amazon Web Services
Microsoft Azureボリュームの作成と管理
この記事には、 Unity Catalogボリュームを作成、管理、および削除するための構文例が記載されています。
ボリューム内のファイルのアップロード、管理、または操作の手順については、「 ボリューム内のファイルの管理」を参照してください。
ボリュームとその内容の表示の詳細については、「 ストレージの表示とデータ ファイルの検索」を参照してください。
ボリュームの一般的な概要については、 Unity Catalogボリュームとは何ですか?」を参照してください。
管理対象ボリュームと外部ボリュームの詳細については、「 管理対象ボリュームと外部ボリューム」を参照してください。
Unity Catalog権限の詳細については、 「ボリュームの権限は何ですか?」を参照してください。
ボリュームの作成
SQL、カタログ エクスプローラー、またはその他のツールを使用してボリュームを作成すると、デフォルトで管理対象ボリュームが作成されます。 外部ボリュームを作成するには、ボリュームを外部ロケーションに関連付けます。
次の手順には、管理対象ボリュームを作成し、オプションでクラウド オブジェクト ストレージの場所を指定して外部ボリュームを作成するための構文例が含まれています。
「カタログエクスプローラ」(Catalog Explorer) でボリュームを作成するには
Databricksワークスペースで、
カタログ。ボリュームを追加するスキーマを検索または参照し、選択します。
「 ボリュームの作成 」ボタンをクリックします。 (十分な権限が必要です。
ボリュームの名前を入力します。
外部ボリュームを作成する場合は、次の操作を行います。
ボリュームを作成する外部ロケーションを選択します。
パスを編集して、ボリュームを作成するサブディレクトリを反映します。
コメントを入力します(オプション)。
[作成]をクリックします。
管理対象ボリュームを作成するには、次の構文を使用します。
CREATE VOLUME <catalog>.<schema>.<volume-name>;
外部ボリュームを作成するには、次の例のように LOCATION 句を追加します。
CREATE EXTERNAL VOLUME <catalog>.<schema>.<external-volume-name>
LOCATION 'gcs://<external-location-bucket-path>/<directory>';
注：
ボリュームを定義すると、ボリューム パスの下のデータへのクラウド URI アクセスはボリュームの権限によって制御されます。
CREATE VOLUME を参照してください。
必要な権限
ボリュームを作成するには、次の権限が必要です。
リソース |
必要な権限 |
|---|---|
スキーマ |
|
カタログ |
|
デフォルトでは、管理対象ボリュームは、それを含むスキーマに関連付けられた管理対象ストレージの場所に作成されます。 「Unity Catalog で管理対象ストレージの場所を指定する」を参照してください。
外部ボリュームを作成するには、 LOCATION句で指定されたクラウド オブジェクト ストレージを管理する外部ロケーションに対するCREATE EXTERNAL VOLUME権限も必要です。 「Unity Catalog を使用してクラウド オブジェクト ストレージに接続する」を参照してください。
ボリュームをドロップする
カタログエクスプローラでボリュームを削除するには:
Databricksワークスペースで、
カタログ。ドロップするボリュームを検索または参照し、選択します。
ボリューム名の右側にある
をクリックし、 [削除] を選択します。表示されるダイアログで [削除 ] をクリックして確認します。
注：
管理対象ボリュームを削除すると、含まれているファイルに削除のマークが付けられますが、外部ボリュームを削除するとマークは付けられません。 管理対象ボリュームと外部ボリュームの動作の違いを参照してください。
必要な権限
所有者権限を持つユーザーのみがボリュームを削除できます。 「 ボリューム所有権」を参照してください。
ボリュームの名前を変更する
カタログエクスプローラでボリュームの名前を変更するには:
Databricksワークスペースで、
カタログ。名前を変更するボリュームを検索または参照し、選択します。
ボリューム名の右側にある
をクリックし、 * 名前の変更 * を選択します。ボリュームの名前を入力します。
[保存]をクリックします。
ボリュームの名前を変更するには、次の構文を使用します。
ALTER VOLUME <volume-name> RENAME TO <new-volume-name>
ALTER VOLUME を参照してください。
必要な権限
所有者権限を持つユーザーのみがボリュームの名前を変更できます。 「 ボリューム所有権」を参照してください。
ボリュームのアクセス許可を変更する
カタログエクスプローラーでボリュームの権限を変更するには、まず権限UIに移動します。
Databricksワークスペースで、
カタログ。変更権限を変更するボリュームを検索または参照し、選択します。
[権限]タブをクリックします。 ボリュームで付与および継承された権限が表示されます。
新しい権限を付与するには、次の操作を行います。
[付与] をクリックします。
プリンシパルを検索するには、入力します。 権限を付与するプリンシパルを選択します。 複数のプリンシパルを選択できます。
付与する権限を選択します。
[付与] をクリックします。
注：
プリンシパルに親リソースに対するUSE CATALOGおよびUSE SCHEMA権限がない場合、追加の権限が必要であることを示す警告が表示されます。 親リソースに対してこれらの権限を付与するのに十分な権限がある場合は、それらの権限も付与するためのチェックボックスが表示されます。
権限を取り消すには、次の操作を行います。
1 つ以上の権限を選択します。
[ 取り消し] をクリックします。
表示されるダイアログで [取り消し ] をクリックして確認します。
GRANT と REVOKE を使用して、ボリュームのアクセス許可を変更します。
たとえば、次の構文はボリュームに READ FILES を付与します。
GRANT READ FILES ON VOLUME <volume-name> TO <principal>
ボリュームの WRITE FILES を取り消すための次の構文:
REVOKE WRITE FILES ON VOLUME <volume-name> TO <principal>
「 Unity Catalog での特権の管理」を参照してください。
必要な権限
所有者権限を持つユーザーのみがボリュームのアクセス許可を付与できます。 「 ボリューム所有権」を参照してください。
ボリューム所有者の変更
カタログエクスプローラでボリュームの所有者を変更するには、次の操作を行います。
Databricksワークスペースで、
カタログ。所有権を変更するボリュームを検索または参照し、選択します。
[ このボリュームについて ]ペインで、[
所有者 ]の横にある をクリックします。プリンシパルを入力して検索し、選択します。
[保存]をクリックします。
ボリュームの所有者を変更するには、次の構文を使用します。
ALTER VOLUME <volume-name> SET OWNER TO <principal-name>
ALTER VOLUME を参照してください。
必要な権限
所有者権限を持つユーザーのみが、ボリュームの所有者を変更できます。 「 ボリューム所有権」を参照してください。