ボリュームの作成と管理

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

• ボリューム内のファイルのアップロード、管理、または操作の手順については、「 ボリューム内のファイルの管理」を参照してください。
• ボリュームとその内容の探索の詳細については、 ストレージの探索とデータ ファイルの検索を参照してください。
• ボリュームの一般的な概要については、「 Unity Catalog ボリュームとは」を参照してください。
• 管理ボリュームと外部ボリュームの詳細については、「 管理ボリュームと外部ボリューム」を参照してください。
• Unity Catalog のアクセス許可の詳細については、「 ボリュームの特権とは」を参照してください。

ボリュームの作成

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

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

Catalog Explorer

To create a volume in Catalog Explorer:

1. In your Databricks workspace, click Catalog.
2. Search or browse for the schema that you want to add the volume to and select it.
3. Click the Create Volume button. (You must have sufficient privileges.)
4. Enter a name for the volume.
5. If you wish to create an external volume, do the following:
   1. Choose an external location in which to create the volume.
   2. Edit the path to reflect the sub-directory where you want to create the volume.
6. Provide a comment (optional).
7. Click Create.

SQL

To create a managed volume, use the following syntax:

SQL

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

To create an external volume, add the LOCATION clause, as in the following example:

SQL

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

注記

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

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

必要な権限

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

リソース	必要な権限
SCHEMA	USE SCHEMA, CREATE VOLUME
CATALOG	USE CATALOG

デフォルトでは、管理対象ボリュームは、包含スキーマに関連付けられた管理対象ストレージの場所に作成されます。 「Unity Catalog で管理されたストレージの場所を指定する」を参照してください。

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

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

Catalog Explorer

To drop a volume in Catalog Explorer:

1. In your Databricks workspace, click Catalog.
2. Search or browse for the volume that you want to drop and select it.
3. Click the to the right of the volume name and select Delete.
4. Click Delete in the dialog that appears to confirm.

SQL

Use the following syntax to drop a volume:

SQL

DROP VOLUME IF EXISTS <volume-name>;

See DROP VOLUME.

注記

管理ボリュームをドロップすると、含まれているファイルは削除対象としてマークされますが、外部ボリュームをドロップすると削除対象にはマークされません。 管理ボリュームと外部ボリュームの動作の違いを参照してください。

必要な権限

所有者特権または MANAGE 特権を持つユーザーは、ボリュームをドロップできます。 ボリューム所有権とMANAGE権限を参照してください。

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

Catalog Explorer

To rename a volume in Catalog Explorer:

1. In your Databricks workspace, click Catalog.
2. Search or browse for the volume that you want to rename and select it.
3. Click the to the right of the volume name and select Rename.
4. Enter a name for the volume.
5. Click Save.

SQL

Use the following syntax to rename a volume:

SQL

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

See ALTER VOLUME.

必要な権限

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

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

Catalog Explorer

To change permissions a volume in Catalog Explorer, start by navigating to the permissions UI:

1. In your Databricks workspace, click Catalog.
2. Search or browse for the volume that you want to modify change permissions on and select it.
3. Click the Permissions tab. Granted and inherited privleges on the volume are displayed.

To grant new privileges, do the following:

1. Click Grant.

2. Type to search for a principal. Select the principal you wish to grant privileges. You can select multiple principals.

3. Select the privileges you wish to grant.

4. Click Grant.

注記

If the principal does not have USE CATALOG and USE SCHEMA privileges on parent resources, a warning appears that additional privileges are required. If you have sufficient permissions on the parent resources to grant those privileges, a checkbox appears to also grant those privileges.

To revoke privileges, do the following:

1. Select one or more grants.
2. Click Revoke.
3. Click Revoke in the dialog that appears to confirm.

SQL

Use GRANT and REVOKE to change permissions on a volume.

For example, the following syntax grants READ VOLUME on a volume:

SQL

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

The following syntax to revokes WRITE VOLUME on a volume:

SQL

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

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

必要な権限

所有者特権または MANAGE 特権を持つユーザーは、ボリュームのアクセス許可を実行できます。 ボリューム所有権とMANAGE権限を参照してください。

ボリューム所有者の変更

Catalog Explorer

To change the owner of a volume in Catalog Explorer, do the following:

1. In your Databricks workspace, click Catalog.
2. Search or browse for the volume that you want to change ownership for and select it.
3. In the About this volume pane, click the next to Owner.
4. Type to search for a principal and select it.
5. Click Save.

SQL

Use the following syntax to change the owner of a volume:

SQL

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

See ALTER VOLUME.

必要な権限

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