volumes kommandogrupp

Kommandogruppen volumes i Databricks CLI innehåller kommandon för att hantera volymer i Unity Catalog. Volymer tillhandahåller funktioner för åtkomst, lagring, styrning, organisering och bearbetning av filer. Se Vad är Unity Catalog-volymer?.

skapa databricks-volymer

Skapa en ny volym.

Användaren kan skapa antingen en extern volym eller en hanterad volym. En extern volym skapas på den angivna externa platsen, medan en hanterad volym finns på standardplatsen som anges av det överordnade schemat, den överordnade katalogen eller metaarkivet.

För att volymskapandet ska lyckas måste användaren uppfylla följande villkor:

• Anroparen måste vara administratör för metaarkivet eller vara ägare till den överordnade katalogen och schemat, eller ha behörigheten USE_CATALOG för den överordnade katalogen och behörigheten USE_SCHEMA för det överordnade schemat.
• Anroparen måste ha CREATE VOLUME behörighet i förälderschemat.

För en extern volym måste även följande villkor uppfyllas:

• Anroparen måste ha CREATE EXTERNAL VOLUME behörighet på den externa platsen.
• Det finns inga andra tabeller eller volymer som finns på den angivna lagringsplatsen. – Den angivna lagringsplatsen är inte placerad under platsen för andra tabeller, volymer, kataloger eller scheman.

databricks volumes create CATALOG_NAME SCHEMA_NAME NAME VOLUME_TYPE [flags]

Arguments

CATALOG_NAME

    Namnet på katalogen där schemat och volymen finns

SCHEMA_NAME

    Namnet på schemat där volymen finns

NAME

    Namnet på volymen

VOLUME_TYPE

    Volymens typ. En extern volym finns på den angivna externa platsen. En hanterad volym finns på standardplatsen som anges av det överordnade schemat, den överordnade katalogen eller metaarkivet. Se Hanterade kontra externa volymer. Värden som stöds: EXTERNAL, MANAGED

Options

--comment string

    Kommentar kopplad till volymen.

--json JSON

    Den inbäddade JSON-strängen eller @path till JSON-filen med begärandekroppen.

--storage-location string

    Lagringsplatsen i molnet.

Globala flaggor

Examples

I följande exempel skapas en hanterad volym:

databricks volumes create my_catalog my_schema my_volume MANAGED

I följande exempel skapas en extern volym med en kommentar:

databricks volumes create my_catalog my_schema my_external_volume EXTERNAL --storage-location s3://my-bucket/my-volume --comment "External volume for data processing"

ta bort databricks-volymer

Ta bort en volym från den angivna överordnade katalogen och schemat.

Anroparen måste vara metaarkivadministratör eller ägare av volymen. I det senare fallet måste anroparen också vara ägare eller ha behörigheten USE_CATALOG för den överordnade katalogen och behörigheten USE_SCHEMA för det överordnade schemat.

databricks volumes delete NAME [flags]

Arguments

NAME

    Volymens namn på tre nivåer (fullständigt kvalificerat)

Options

Globala flaggor

Examples

I följande exempel tas en volym bort:

databricks volumes delete my_catalog.my_schema.my_volume

databricks-volymlista

Lista volymer för det aktuella metaarkivet under den överordnade katalogen och schemat.

De returnerade volymerna filtreras baserat på den anropande användarens behörigheter. Till exempel kan metaarkivadministratören visa en lista över alla volymer. En vanlig användare måste vara ägare eller ha READ VOLUME-behörighet för volymen för att få volymerna i svaret. I det senare fallet måste anroparen också vara ägare eller ha behörigheten USE_CATALOG för den överordnade katalogen och behörigheten USE_SCHEMA för det överordnade schemat.

Det finns ingen garanti för en specifik ordning på elementen i matrisen.

databricks volumes list CATALOG_NAME SCHEMA_NAME [flags]

Arguments

CATALOG_NAME

    Katalogens identifierare

SCHEMA_NAME

    Identifieraren för schemat

Options

--include-browse

    Huruvida man ska inkludera volymer i svaret som principalen endast har tillgång till selektiv metadata för.

--max-results int

    Maximalt antal volymer som ska returneras (sidlängd).

--page-token string

    Ogenomskinlig token som returnerades av en tidigare begäran.

Globala flaggor

Examples

I följande exempel visas alla volymer i en katalog och ett schema:

databricks volumes list my_catalog my_schema

läsa av databricks-volymer

Hämta en volym från metaarkivet för en specifik katalog och ett visst schema.

Anroparen måste vara en metaarkivadministratör eller ägare av (eller ha behörigheten READ VOLUME på) volymen. I det senare fallet måste anroparen också vara ägare eller ha behörigheten USE_CATALOG för den överordnade katalogen och behörigheten USE_SCHEMA för det överordnade schemat.

databricks volumes read NAME [flags]

Arguments

NAME

    Volymens namn på tre nivåer (fullständigt kvalificerat)

Options

--include-browse

    Huruvida man ska inkludera volymer i svaret som principalen endast har tillgång till selektiv metadata för.

Globala flaggor

Examples

I följande exempel hämtas information om en volym:

databricks volumes read my_catalog.my_schema.my_volume

I följande exempel hämtas volyminformation inklusive bläddringsmetadata:

databricks volumes read my_catalog.my_schema.my_volume --include-browse

uppdatering av databricks-volymer

Uppdatera den angivna volymen under den angivna huvudkatalogen och schemat.

Anroparen måste vara metaarkivadministratör eller ägare av volymen. I det senare fallet måste anroparen också vara ägare eller ha behörigheten USE_CATALOG för den överordnade katalogen och behörigheten USE_SCHEMA för det överordnade schemat.

För närvarande kan endast namnet, ägaren eller kommentaren för volymen uppdateras.

databricks volumes update NAME [flags]

Arguments

NAME

    Volymens namn på tre nivåer (fullständigt kvalificerat)

Options

--comment string

    Kommentar kopplad till volymen.

--json JSON

    Den inbäddade JSON-strängen eller @path till JSON-filen med begärandekroppen.

--new-name string

    Nytt namn på volymen.

--owner string

    Identifieraren för den användare som äger volymen.

Globala flaggor

Examples

I följande exempel uppdateras en volymkommentare:

databricks volumes update my_catalog.my_schema.my_volume --comment "Updated comment for my volume"

I följande exempel ändras ägaren till en volym:

databricks volumes update my_catalog.my_schema.my_volume --owner someone@example.com

I följande exempel byter du namn på en volym:

databricks volumes update my_catalog.my_schema.my_volume --new-name my_new_volume_name

Globala flaggor

--debug

  Om felsökningsloggning ska aktiveras.

-h eller --help

    Visa hjälp för Databricks CLI eller den relaterade kommandogruppen eller det relaterade kommandot.

--log-file sträng

    En sträng som representerar filen som utdataloggarna ska skrivas till. Om den här flaggan inte anges är standardvärdet att skriva utdataloggar till stderr.

--log-format format

    Loggformattypen, text eller json. Standardvärdet är text.

--log-level sträng

    En sträng som representerar loggformatnivån. Om det inte anges inaktiveras loggformatnivån.

-o, --output typ

    Kommandots utdatatyp, text eller json. Standardvärdet är text.

-p, --profile sträng

    Namnet på profilen i ~/.databrickscfg-filen som ska användas för att köra kommandot. Om den här flaggan inte anges används den namngivna DEFAULT profilen om den finns.

--progress-format format

    Formatet för att visa förloppsloggar: default, append, inplaceeller json

-t, --target sträng

    Om tillämpligt, paketmålet som ska användas