ボリュームの作成と管理

この記事には、 Unity Catalogボリュームを作成、管理、および削除するための構文例が記載されています。

ボリューム内のファイルのアップロード、管理、または操作の手順については、ボリューム内のファイルの管理を参照してください。
ボリュームとその内容の表示の詳細については、ストレージの表示とデータファイルの検索を参照してください。
ボリュームの一般的な概要については、 Unity Catalogボリュームとは何ですか?を参照してください。
マネージドボリュームと外部ボリュームの詳細については、マネージドボリュームと外部ボリュームを参照してください。
Unity Catalog権限の詳細については、「ボリュームに対する権限とは何ですか?を参照してください。

ボリュームの作成

SQL、カタログエクスプローラー、またはその他のツールを使用してボリュームを作成すると、デフォルトでマネージドボリュームが作成されます。外部ボリュームを作成するには、ボリュームを外部ロケーションに関連付けます。

次の手順には、マネージドボリュームを作成し、オプションでクラウドオブジェクトストレージの場所を指定して外部ボリュームを作成するための構文例が含まれています。

「カタログエクスプローラ」(Catalog Explorer) でボリュームを作成するには

Databricksワークスペースで、カタログ。
ボリュームを追加するスキーマを検索または参照し、選択します。
ボリュームの作成 ボタンをクリックします。 (十分な権限が必要です。)
ボリュームの名前を入力します。
外部ボリュームを作成する場合は、次の操作を行います。
1. ボリュームを作成する外部ロケーションを選択します。
2. パスを編集して、ボリュームを作成するサブディレクトリを反映します。
コメントを入力します(オプション)。
作成をクリックします。

マネージドボリュームを作成するには、次の構文を使用します。

CREATE VOLUME <catalog>.<schema>.<volume-name>;

外部ボリュームを作成するには、次の例のように LOCATION 句を追加します。

CREATE EXTERNAL VOLUME <catalog>.<schema>.<external-volume-name>
LOCATION 's3://<external-location-bucket-path>/<directory>';

注：

外部ボリュームを定義すると、ボリュームパスの下のデータへのクラウド URI アクセスは、ボリュームが格納されている外部ロケーションで付与される特権ではなく、ボリュームで付与される特権によって制御されます。

CREATE VOLUME を参照してください。

必要な権限

ボリュームを作成するには、次の権限が必要です。

リソース	必要な権限
スキーマ	`USE SCHEMA`, `CREATE VOLUME`
カタログ	`USE CATALOG`

デフォルトでは、マネージドボリュームは、包含スキーマに関連付けられたマネージドストレージの場所に作成されます。 Unity Catalog でマネージドストレージロケーションを指定するを参照してください。

外部ボリュームを作成するには、LOCATION 節で指定されているクラウド・オブジェクト・ストレージを管理する外部ロケーションに対する CREATE EXTERNAL VOLUME 特権も必要です。Unity Catalog を使用してクラウドオブジェクトストレージとサービスに接続するを参照してください。

ボリュームをドロップする

カタログエクスプローラでボリュームを削除するには:

Databricksワークスペースで、カタログ。
ドロップするボリュームを検索または参照し、選択します。
ボリューム名の右側にあるをクリックし、削除を選択します。
表示されるダイアログで削除をクリックして確認します。

ボリュームを削除するには、次の構文を使用します。

DROP VOLUME IF EXISTS <volume-name>;

DROP VOLUME を参照してください。

注：

マネージドボリュームを削除すると、含まれているファイルに削除のマークが付けられますが、外部ボリュームを削除するとマークは付けられません。マネージドボリュームと外部ボリュームの動作の違いを参照してください。

必要な権限

所有者権限を持つユーザーのみがボリュームを削除できます。ボリューム所有権を参照してください。

ボリュームの名前を変更する

カタログエクスプローラでボリュームの名前を変更するには:

Databricksワークスペースで、カタログ。
名前を変更するボリュームを検索または参照し、選択します。
ボリューム名の右側にあるをクリックし、 名前の変更 を選択します。
ボリュームの名前を入力します。
保存をクリックします。

ボリュームの名前を変更するには、次の構文を使用します。

ALTER VOLUME <volume-name> RENAME TO <new-volume-name>

ALTER VOLUME を参照してください。

必要な権限

所有者権限を持つユーザーのみがボリュームの名前を変更できます。ボリューム所有権を参照してください。

ボリュームのアクセス許可を変更する

カタログエクスプローラーでボリュームの権限を変更するには、まず権限UIに移動します。

Databricksワークスペースで、カタログ。
変更権限を変更するボリュームを検索または参照し、選択します。
権限タブをクリックします。ボリュームで付与および継承された権限が表示されます。

新しい権限を付与するには、次の操作を行います。

付与をクリックします。
プリンシパルを検索するには、入力します。権限を付与するプリンシパルを選択します。複数のプリンシパルを選択できます。
付与する権限を選択します。
付与をクリックします。

注：

プリンシパルに親リソースに対するUSE CATALOGおよびUSE SCHEMA権限がない場合、追加の権限が必要であることを示す警告が表示されます。親リソースに対してこれらの権限を付与するのに十分な権限がある場合は、それらの権限も付与するためのチェックボックスが表示されます。

権限を取り消すには、次の操作を行います。

1 つ以上の権限を選択します。
取り消しをクリックします。
表示されるダイアログで 取り消しをクリックして確認します。

GRANT と REVOKE を使用して、ボリュームのアクセス許可を変更します。

たとえば、次の構文はボリュームに READ VOLUME を付与します。

GRANT READ VOLUME ON VOLUME <volume-name> TO <principal>

ボリュームの WRITE VOLUME を取り消すための次の構文:

REVOKE WRITE VOLUME ON VOLUME <volume-name> TO <principal>

Unity Catalog での特権の管理を参照してください。

必要な権限

所有者権限を持つユーザーのみがボリュームのアクセス許可を付与できます。ボリューム所有権を参照してください。

ボリューム所有者の変更

カタログエクスプローラでボリュームの所有者を変更するには、次の操作を行います。

Databricksワークスペースで、カタログ。
所有権を変更するボリュームを検索または参照し、選択します。
このボリュームについてペインで、 所有者の横にあるをクリックします。
プリンシパルを入力して検索し、選択します。
保存をクリックします。

ボリュームの所有者を変更するには、次の構文を使用します。

ALTER VOLUME <volume-name> SET OWNER TO <principal-name>

ALTER VOLUME を参照してください。

必要な権限

所有者権限を持つユーザーのみが、ボリュームの所有者を変更できます。ボリューム所有権を参照してください。