ボリュームの作成と管理
この記事には、Unity Catalog ボリュームを作成、管理、削除するための構文例が含まれています。
- ボリューム内のファイルのアップロード、管理、または操作の手順については、「 ボリューム内のファイルの管理」を参照してください。
- ボリュームとその内容の探索の詳細については、 ストレージの探索とデータ ファイルの検索を参照してください。
- ボリュームの一般的な概要については、「 Unity Catalog ボリュームとは」を参照してください。
- 管理ボリュームと外部ボリュームの詳細については、「 管理ボリュームと外部ボリューム」を参照してください。
- Unity Catalog のアクセス許可の詳細については、「 ボリュームの特権とは」を参照してください。
ボリュームの作成
SQL、カタログ エクスプローラー、またはその他のツールを使用してボリュームを作成すると、デフォルトでマネージドボリュームが作成されます。 外部ボリュームを作成するには、ボリュームを外部ロケーションに関連付けます。
次の手順には、マネージドボリュームを作成し、オプションでクラウド オブジェクト ストレージの場所を指定して外部ボリュームを作成するための構文例が含まれています。
- Catalog Explorer
- SQL
カタログエクスプローラーでボリュームを作成するには:
-
Databricks ワークスペースで、
カタログ をクリックします。
-
ボリュームを追加するスキーマを検索または参照し、それを選択します。
-
ボリュームの作成 ボタンをクリックします。 (十分な権限が必要です。)
-
ボリュームの名前を入力します。
-
外部ボリュームを作成する場合は、次の操作を行います。
- ボリュームを作成する外部ロケーションを選択します。
- ボリュームを作成するサブディレクトリを反映するようにパスを編集します。
-
コメントを入力します (省略可能)。
-
作成 をクリックします。
マネージドボリュームを作成するには、次の構文を使用します。
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を参照してください。
必要な権限
ボリュームを作成するには、次の権限が必要です。
リソース | 必要な権限 |
---|---|
SCHEMA |
|
CATALOG |
|
デフォルトでは、管理対象ボリュームは、包含スキーマに関連付けられた管理対象ストレージの場所に作成されます。 「Unity Catalog で管理されたストレージの場所を指定する」を参照してください。
外部ボリュームを作成するには、LOCATION
節で指定されているクラウド・オブジェクト・ストレージを管理する外部ロケーションに対する CREATE EXTERNAL VOLUME
特権も必要です。「Unity Catalog を使用してクラウド オブジェクト ストレージとサービスに接続する」を参照してください。
ボリュームをドロップする
- Catalog Explorer
- SQL
カタログエクスプローラーでボリュームをドロップするには:
- Databricks ワークスペースで、
カタログ をクリックします。
- ドロップするボリュームを検索または参照し、選択します。
- ボリューム名の右側にある
をクリックし、 削除 を選択します。
- 表示されるダイアログで 削除 をクリックして確認します。
管理ボリュームをドロップすると、含まれているファイルは削除対象としてマークされますが、外部ボリュームをドロップすると削除対象にはマークされません。 管理ボリュームと外部ボリュームの動作の違いを参照してください。
必要な権限
所有者特権または MANAGE
特権を持つユーザーは、ボリュームをドロップできます。 ボリューム所有権とMANAGE
権限を参照してください。
ボリュームの名前を変更する
- Catalog Explorer
- SQL
カタログエクスプローラーでボリュームの名前を変更するには:
- Databricks ワークスペースで、
カタログ をクリックします。
- 名前を変更するボリュームを検索または参照し、選択します。
- ボリューム名の右側にある
をクリックし、 名前の変更 を選択します。
- ボリュームの名前を入力します。
- 保存 をクリックします。
次の構文を使用して、ボリュームの名前を変更します。
ALTER VOLUME <volume-name> RENAME TO <new-volume-name>
ALTER VOLUMEを参照してください。
必要な権限
所有者特権または MANAGE
特権を持つユーザーは、ボリュームの名前を変更できます。 ボリューム所有権とMANAGE
権限を参照してください。
ボリュームのアクセス許可を変更する
- Catalog Explorer
- SQL
Catalog Explorer でボリュームの権限を変更するには、まず権限 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 での特権の管理」を参照してください。
必要な権限
所有者特権または MANAGE
特権を持つユーザーは、ボリュームのアクセス許可を実行できます。 ボリューム所有権とMANAGE
権限を参照してください。
ボリューム所有者の変更
- Catalog Explorer
- SQL
カタログエクスプローラでボリュームの所有者を変更するには、次の手順を実行します。
- Databricks ワークスペースで、
カタログ をクリックします。
- 所有権を変更するボリュームを検索または参照し、それを選択します。
- [ About this volume] ペインで、[
Owner] の横にある をクリックします。
- 入力してプリンシパルを検索し、それを選択します。
- 保存 をクリックします。
次の構文を使用して、ボリュームの所有者を変更します。
ALTER VOLUME <volume-name> SET OWNER TO <principal-name>
ALTER VOLUMEを参照してください。
必要な権限
所有者特権または MANAGE
特権を持つユーザーは、ボリュームの所有者を変更できます。 ボリューム所有権とMANAGE
権限を参照してください。