Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Note
Deze informatie is van toepassing op Databricks CLI-versies 0.205 en hoger. De Databricks CLI bevindt zich in openbare preview.
Databricks CLI-gebruik is onderhevig aan de Databricks-licentie en de privacyverklaring van Databricks, met inbegrip van alle bepalingen voor gebruiksgegevens.
De volumes opdrachtgroep in de Databricks CLI bevat opdrachten voor het beheren van volumes in Unity Catalog. Volumes bieden functies voor het openen, opslaan, beheren, ordenen en verwerken van bestanden. Zie Wat zijn Unity Catalog-volumes?
databricks-volumes maken
Maak een nieuw volume.
De gebruiker kan een extern volume of een beheerd volume maken. Er wordt een extern volume gemaakt op de opgegeven externe locatie, terwijl een beheerd volume zich op de standaardlocatie bevindt die is opgegeven door het bovenliggende schema, of de bovenliggende catalogus of de metastore.
De gebruiker moet aan de volgende voorwaarden voldoen om het volume te kunnen maken:
- De aanroeper moet een metastore-beheerder zijn, of de eigenaar van de bovenliggende catalogus en het schema zijn, of de
USE_CATALOGbevoegdheid hebben voor de bovenliggende catalogus en deUSE_SCHEMAbevoegdheid voor het bovenliggende schema. - De aanroeper moet
CREATE VOLUMEbevoegdheid hebben op het bovenliggende schema.
Voor een extern volume moeten ook aan de volgende voorwaarden worden voldaan:
- De beller moet bevoegdheden hebben
CREATE EXTERNAL VOLUMEop de externe locatie. - Er zijn geen andere tabellen, noch volumes die aanwezig zijn op de opgegeven opslaglocatie. - De opgegeven opslaglocatie bevindt zich niet onder de locatie van andere tabellen, volumes, catalogi of schema's.
databricks volumes create CATALOG_NAME SCHEMA_NAME NAME VOLUME_TYPE [flags]
Arguments
CATALOG_NAME
De naam van de catalogus waarin het schema en het volume zich bevinden
SCHEMA_NAME
De naam van het schema waarin het volume zich bevindt
NAME
De naam van het volume
VOLUME_TYPE
Het type volume. Een extern volume bevindt zich op de opgegeven externe locatie. Een beheerd volume bevindt zich op de standaardlocatie die is opgegeven door het bovenliggende schema, de bovenliggende catalogus of de Metastore. Zie Beheerde versus externe volumes. Ondersteunde waarden: EXTERNAL, MANAGED
Options
--comment string
De opmerking die aan het volume is gekoppeld.
--json JSON
De inline JSON-tekenreeks of de link @path naar het JSON-bestand met de body van het verzoek.
--storage-location string
De opslaglocatie in de cloud.
Examples
In het volgende voorbeeld wordt een beheerd volume gemaakt:
databricks volumes create my_catalog my_schema my_volume MANAGED
In het volgende voorbeeld wordt een extern volume gemaakt met een opmerking:
databricks volumes create my_catalog my_schema my_external_volume EXTERNAL --storage-location s3://my-bucket/my-volume --comment "External volume for data processing"
Databricks-volumes verwijderen
Verwijder een volume uit de opgegeven bovenliggende catalogus en het opgegeven schema.
De beller moet een metastore-beheerder of eigenaar van het volume zijn. In het laatste geval moet de oproeper ook de eigenaar zijn of over de USE_CATALOG bevoegdheid beschikken voor de bovenliggende catalogus en de USE_SCHEMA bevoegdheid voor het bovenliggende schema.
databricks volumes delete NAME [flags]
Arguments
NAME
De volledig gekwalificeerde naam van het volume met drie niveaus
Options
Examples
In het volgende voorbeeld wordt een volume verwijderd:
databricks volumes delete my_catalog.my_schema.my_volume
lijst met databricks-volumes
Lijst volumes voor de huidige metastore onder de bijbehorende catalogus en het bijbehorende schema.
De geretourneerde volumes worden gefilterd op basis van de bevoegdheden van de aanroepende gebruiker. De metastore-beheerder kan bijvoorbeeld alle volumes weergeven. Een gewone gebruiker moet de eigenaar zijn of beschikken over de READ VOLUME bevoegdheid op het volume om de volumes in de respons te ontvangen. In het laatste geval moet de oproeper ook de eigenaar zijn of over de USE_CATALOG bevoegdheid beschikken voor de bovenliggende catalogus en de USE_SCHEMA bevoegdheid voor het bovenliggende schema.
Er is geen garantie voor een specifieke volgorde van de elementen in de matrix.
databricks volumes list CATALOG_NAME SCHEMA_NAME [flags]
Arguments
CATALOG_NAME
De id van de catalogus
SCHEMA_NAME
De identificatiecode van het schema
Options
--include-browse
Of volumes moeten worden opgenomen in het antwoord waarvoor de principal alleen toegang heeft tot selectieve metagegevens.
--max-results int
Maximum aantal volumes dat moet worden geretourneerd (paginalengte).
--page-token string
Ondoorzichtige sleutel geretourneerd door een vorig verzoek.
Examples
In het volgende voorbeeld worden alle volumes in een catalogus en schema weergegeven:
databricks volumes list my_catalog my_schema
databricks-volumes gelezen
Haal een volume op uit de metastore voor een specifieke catalogus en een specifiek schema.
De beller moet een metastore-beheerder of eigenaar van het volume zijn (of over de READ VOLUME bevoegdheid beschikken). In het laatste geval moet de oproeper ook de eigenaar zijn of over de USE_CATALOG bevoegdheid beschikken voor de bovenliggende catalogus en de USE_SCHEMA bevoegdheid voor het bovenliggende schema.
databricks volumes read NAME [flags]
Arguments
NAME
De volledig gekwalificeerde naam van het volume met drie niveaus
Options
--include-browse
Of volumes moeten worden opgenomen in het antwoord waarvoor de principal alleen toegang heeft tot selectieve metagegevens.
Examples
In het volgende voorbeeld wordt informatie opgehaald over een volume:
databricks volumes read my_catalog.my_schema.my_volume
In het volgende voorbeeld wordt volume-informatie verkregen, waaronder browse-metagegevens.
databricks volumes read my_catalog.my_schema.my_volume --include-browse
Update van Databricks-volumes
Werk het opgegeven volume bij binnen de opgegeven bovenliggende catalogus en schema.
De beller moet een metastore-beheerder of eigenaar van het volume zijn. In het laatste geval moet de oproeper ook de eigenaar zijn of over de USE_CATALOG bevoegdheid beschikken voor de bovenliggende catalogus en de USE_SCHEMA bevoegdheid voor het bovenliggende schema.
Momenteel kan alleen de naam, de eigenaar of de opmerking van het volume worden bijgewerkt.
databricks volumes update NAME [flags]
Arguments
NAME
De volledig gekwalificeerde naam van het volume met drie niveaus
Options
--comment string
De opmerking die aan het volume is gekoppeld.
--json JSON
De inline JSON-tekenreeks of de link @path naar het JSON-bestand met de body van het verzoek.
--new-name string
Nieuwe naam voor het volume.
--owner string
De id van de gebruiker die eigenaar is van het volume.
Examples
In het volgende voorbeeld wordt de opmerking van een volume bijgewerkt:
databricks volumes update my_catalog.my_schema.my_volume --comment "Updated comment for my volume"
In het volgende voorbeeld wordt de eigenaar van een volume gewijzigd:
databricks volumes update my_catalog.my_schema.my_volume --owner someone@example.com
In het volgende voorbeeld wordt de naam van een volume gewijzigd:
databricks volumes update my_catalog.my_schema.my_volume --new-name my_new_volume_name
Globale vlaggen
--debug
Of u logboekregistratie voor foutopsporing wilt inschakelen.
-h of --help
Help weergeven voor de Databricks CLI, de bijbehorende opdrachtgroep of de bijbehorende opdracht.
--log-file snaar
Een tekenreeks die het bestand aangeeft waar uitvoerlogboeken naar moeten worden geschreven. Als deze vlag niet is opgegeven, is het standaardinstelling om uitvoerlogboeken naar stderr te schrijven.
--log-format formatteren
Het logformaat type, text of json. De standaardwaarde is text.
--log-level snaar
Een tekenreeks die het niveau van de logboekindeling vertegenwoordigt. Als dit niet is opgegeven, wordt het niveau van de logboekindeling uitgeschakeld.
-o, --output type
Het type uitvoer van de opdracht, text of json. De standaardwaarde is text.
-p, --profile snaar
De naam van het profiel in het ~/.databrickscfg bestand dat moet worden gebruikt om de opdracht uit te voeren. Als deze vlag niet is opgegeven en hij bestaat, wordt het profiel met de naam DEFAULT gebruikt.
--progress-format formatteren
De indeling voor het weergeven van voortgangslogboeken: default, append, inplaceof json
-t, --target snaar
Indien van toepassing, het bundeldoel dat moet worden gebruikt