Erstellen und Verwalten von Unity-Katalogvolumes

Diese Seite enthält Syntaxbeispiele zum Erstellen, Verwalten und Ablegen von Unity-Katalogvolumes.

• Anweisungen zum Hochladen, Verwalten oder Arbeiten mit Dateien in Volumes finden Sie unter "Arbeiten mit Dateien in Unity Catalog-Volumes".
• Ausführliche Informationen zum Untersuchen von Volumes und ihren Inhalten finden Sie unter Durchsuchen von Speicher- und Datendateien.
• Eine allgemeine Übersicht über Volumes finden Sie unter Was sind Unity Catalog-Volumes?.
• Ausführliche Informationen zu verwalteten und externen Volumes finden Sie unter Verwaltete und externe Volumes.
• Details zu Unity-Katalogberechtigungen finden Sie unter "Berechtigungen für Unity-Katalogvolumes".

Erstellen eines Volumes

Wenn Sie ein Volume mit SQL, dem Katalog-Explorer oder anderen Tools erstellen, wird standardmäßig ein verwaltetes Volume erstellt. Um ein externes Volume zu erstellen, ordnen Sie das Volume einem externen Speicherort zu.

Die folgenden Anweisungen enthalten eine Beispielsyntax zum Erstellen von verwalteten Volumes und zum optionalen Angeben eines Cloudobjektspeicherorts zum Erstellen eines externen Volumes.

Katalog-Explorer

So erstellen Sie ein Volume im Katalog-Explorer

1. Klicken Sie im Azure Databricks-Arbeitsbereich auf das Katalog.
2. Suchen Sie nach dem Schema, dem Sie das Volume hinzufügen möchten, und wählen Sie es aus.
3. Klicken Sie auf "Erstellen>Volume". (Sie müssen über ausreichende Berechtigungen verfügen.)
4. Geben Sie einen Namen für das Volume ein.
5. Wählen Sie aus, ob ein verwaltetes oder externes Volume erstellt werden soll. Siehe verwaltete und externe Volumes.
6. Wenn Sie ein externes Volume erstellen, gehen Sie wie folgt vor:
   1. Wählen Sie einen externen Speicherort aus, an dem das Volume erstellt werden soll.
   2. Bearbeiten Sie den Pfad, um das Unterverzeichnis widerzuspiegeln, in dem Sie das Volume erstellen möchten.
7. Klicken Sie auf Erstellen.

SQL

Verwenden Sie die folgende Syntax, um ein verwaltetes Volume zu erstellen:

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

Um ein externes Volume zu erstellen, fügen Sie die LOCATION-Klausel wie im folgenden Beispiel hinzu:

CREATE EXTERNAL VOLUME <catalog>.<schema>.<external-volume-name>
LOCATION 'abfss://<container-name>@<storage-account>.dfs.core.windows.net/<path>/<directory>';

Hinweis

Wenn Sie ein externes Volume definieren, UNTERLIEGT der Cloud-URI-Zugriff auf Daten unter dem Volumepfad den Berechtigungen, die auf dem Volume gewährt werden, nicht den Berechtigungen, die für den externen Speicherort gewährt werden, an dem das Volume gespeichert ist.

Siehe CREATE VOLUME.

Erforderliche Berechtigungen

Sie benötigen die folgenden Berechtigungen, um ein Volume zu erstellen:

Ressource	Erforderliche Berechtigungen
Schema	USE SCHEMA, CREATE VOLUME
Katalog	USE CATALOG

Standardmäßig werden verwaltete Volumes im verwalteten Speicherort erstellt, der dem enthaltenden Schema zugeordnet ist. Weitere Informationen finden Sie unter Angeben eines verwalteten Speicherorts in Unity Catalog.

Um ein externes Volumes zu erstellen, müssen Sie auch über die Berechtigung CREATE EXTERNAL VOLUME für den externen Speicherort verfügen, der den in Ihrer LOCATION-Klausel angegebenen Cloudobjektspeicher verwaltet. Siehe Verbinden mit Cloudobjektspeicher mithilfe des Unity-Katalogs.

Löschen eines Volumes

Katalog-Explorer

So löschen Sie ein Volume im Katalog-Explorer

1. Klicken Sie im Azure Databricks-Arbeitsbereich auf das Katalog.
2. Suchen oder suchen Sie nach dem Volume, das Sie löschen möchten, und wählen Sie es aus.
3. Klicken Sie auf das Rechts neben dem Volumenamen, und wählen Sie "Löschen" aus.
4. Klicken Sie im Dialogfeld auf Löschen, das angezeigt wird, um dies zu bestätigen.

SQL

Verwenden Sie die folgende Syntax, um ein Volume zu löschen:

DROP VOLUME IF EXISTS <volume-name>;

Siehe DROP VOLUME.

Hinweis

Wenn Sie ein verwaltetes Volume trennen, werden die enthaltenen Dateien zum Löschen markiert, bei einem externen Volume ist dies jedoch nicht der Fall. Siehe verwaltete und externe Volumes.

Erforderliche Berechtigungen

Benutzer mit Eigentümerrechten oder dem MANAGE-Privileg können ein Volume löschen. Siehe Eigentümerschaft des Volumens und MANAGE Berechtigungen.

Umbenennen eines Volumes

Katalog-Explorer

So benennen Sie ein Volume im Katalog-Explorer um:

1. Klicken Sie im Azure Databricks-Arbeitsbereich auf das Katalog.
2. Suchen oder suchen Sie nach dem Volume, das Sie umbenennen möchten, und wählen Sie es aus.
3. Klicken Sie auf das Rechts neben dem Volumenamen, und wählen Sie "Umbenennen" aus.
4. Geben Sie einen Namen für das Volume ein.
5. Klicken Sie auf Speichern.

SQL

Verwenden Sie die folgende Syntax, um ein Volume umzubenennen:

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

Siehe ALTER VOLUME.

Erforderliche Berechtigungen

Benutzer mit Besitzerrechten oder der MANAGE-Berechtigung können ein Volume umbenennen. Siehe Eigentümerschaft des Volumens und MANAGE Berechtigungen.

Ändern der Berechtigungen für ein Volume

Katalog-Explorer

Um Berechtigungen für ein Volume im Katalog-Explorer zu ändern, navigieren Sie zunächst zur Berechtigungs-UI:

1. Klicken Sie im Azure Databricks-Arbeitsbereich auf das Katalog.
2. Suchen oder suchen Sie nach dem Volume, für das Sie Änderungsberechtigungen ändern möchten, und wählen Sie es aus.
3. Klicken Sie auf die Registerkarte Permissions . Gewährte und geerbte Berechtigungen auf dem Volume werden angezeigt.

Gehen Sie wie folgt vor, um neue Berechtigungen zu gewähren:

1. Klicken Sie auf Erteilen.
2. Geben Sie den Typ ein, um nach einem Prinzipal zu suchen. Wählen Sie den Prinzipal aus, den Sie Berechtigungen erteilen möchten. Sie können mehrere Prinzipale auswählen.
3. Wählen Sie die Berechtigungen aus, die Sie erteilen möchten.
4. Klicken Sie auf Erteilen.

Hinweis

Wenn der Prinzipal nicht über USE CATALOG und USE SCHEMA Berechtigungen für übergeordnete Ressourcen verfügt, wird eine Warnung angezeigt, dass zusätzliche Berechtigungen erforderlich sind. Wenn Sie über ausreichende Berechtigungen für die übergeordneten Ressourcen verfügen, um diese Berechtigungen zu gewähren, wird ein Kontrollkästchen angezeigt, um auch diese Berechtigungen zu gewähren.

Gehen Sie wie folgt vor, um Berechtigungen zu widerrufen:

1. Wählen Sie mindestens eine Gewährung aus.
2. Klicken Sie auf Widerrufen.
3. Klicken Sie im Dialogfeld auf Widerrufen, das angezeigt wird, um dies zu bestätigen.

SQL

Verwenden Sie GRANT und REVOKE, um Berechtigungen für ein Volume zu ändern.

Die folgende Syntax gewährt beispielsweise die Berechtigung READ VOLUME für ein Volume:

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

Die folgende Syntax widerruft die Berechtigung WRITE VOLUME für ein Volume:

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

Weitere Informationen finden Sie unter Verwalten von Berechtigungen in Unity Catalog.

Erforderliche Berechtigungen

Benutzer mit Eigentümerrechten oder mit MANAGE Berechtigungen können Berechtigungen für ein Volume ändern. Siehe Eigentümerschaft des Volumens und MANAGE Berechtigungen.

Ändern des Volumebesitzers

Katalog-Explorer

Gehen Sie wie folgt vor, um den Besitzer eines Volumes im Katalog-Explorer zu ändern:

1. Klicken Sie im Azure Databricks-Arbeitsbereich auf das Katalog.
2. Suchen oder suchen Sie nach dem Volume, für das Sie den Besitz ändern möchten, und wählen Sie es aus.
3. Klicken Sie im Bereich Über dieses Volume auf nebenBesitzer.
4. Geben Sie die Eingabe ein, um nach einem Prinzipal zu suchen, und wählen Sie ihn aus.
5. Klicken Sie auf Speichern.

SQL

Verwenden Sie die folgende Syntax, um den Besitzer eines Volumes zu ändern:

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

Siehe ALTER VOLUME.

Erforderliche Berechtigungen

Benutzer mit Besitzerberechtigungen oder MANAGE-Berechtigungen können den Besitzer des Volumens ändern. Siehe Eigentümerschaft des Volumens und MANAGE Berechtigungen.