ボリュームの作成と管理

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

ボリュームの作成

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

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

管理対象ボリュームを作成するには、次の構文を使用します。

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

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

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

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

  1. Databricksワークスペースで、カタログ アイコンカタログ。

  2. ボリュームを追加するスキーマを検索または参照し、選択します。

  3. 「 ボリュームの作成 」ボタンをクリックします。 (十分な権限が必要です。

  4. ボリュームの名前を入力します。

  5. 外部ボリュームを作成する場合は、次の操作を行います。

    1. ボリュームを作成する外部ロケーションを選択します。

    2. パスを編集して、ボリュームを作成するサブディレクトリを反映します。

  6. コメントを入力します(オプション)。

  7. [作成]をクリックします。

注：

ボリュームを定義すると、ボリューム パスの下のデータへのクラウド URI アクセスはボリュームの権限によって制御されます。

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

必要な権限

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

リソース

必要な権限

スキーマ

USE SCHEMA, CREATE VOLUME

カタログ

USE CATALOG

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

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

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

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

DROP VOLUME IF EXISTS <volume-name>;

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

注：

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

必要な権限

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

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

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

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

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

必要な権限

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

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

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 での特権の管理」を参照してください。

必要な権限

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

ボリューム所有者の変更

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

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

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

必要な権限

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