schemas kommandogrupp

Note

Den här informationen gäller för Databricks CLI-versionerna 0.205 och senare. Databricks CLI finns i offentlig förhandsversion.

Databricks CLI-användning omfattas av Databricks-licensen och Databricks sekretessmeddelande, inklusive eventuella användningsdatabestämmelser.

Kommandogruppen schemas i Databricks CLI innehåller kommandon för att hantera scheman i Unity Catalog. Ett schema är det andra lagret i Unity Catalogs namnområde på tre nivåer. Ett schema organiserar tabeller, vyer och funktioner. Se Vad är scheman i Azure Databricks?.

databricks-scheman skapa

Skapa ett nytt schema för katalogen i metaarkivet. Anroparen måste vara metaarkivadministratör eller ha behörigheten CREATE_SCHEMA i den överordnade katalogen.

databricks schemas create NAME CATALOG_NAME [flags]

Arguments

NAME

    Namnet på schemat i förhållande till den överordnade katalogen.

CATALOG_NAME

    Namn på huvudkatalog.

Options

--comment string

    Beskrivning av text i fritt formulär som tillhandahålls av användaren.

--json JSON

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

--storage-root string

    Lagringsrot-URL för hanterade tabeller i schemat.

Globala flaggor

Examples

I följande exempel skapas ett nytt schema med namnet analytics i main katalogen:

databricks schemas create analytics main

I följande exempel skapas ett nytt schema med en kommentar:

databricks schemas create analytics main --comment "Schema for analytics data"

ta bort databricks-scheman

Ta bort det angivna schemat från den överordnade katalogen. Anroparen måste vara ägare till schemat eller ägare till den överordnade katalogen.

databricks schemas delete FULL_NAME [flags]

Arguments

FULL_NAME

    Fullständigt namn på schemat.

Options

--force

    Framtvinga borttagning även om schemat inte är tomt.

Globala flaggor

Examples

I följande exempel tas ett schema bort:

databricks schemas delete main.analytics

I följande exempel tas ett schema bort även om det inte är tomt:

databricks schemas delete main.analytics --force

databricks-scheman hämtas

Hämta det angivna schemat i metaarkivet. Anroparen måste vara metaarkivadministratör, ägare till schemat eller en användare som har USE_SCHEMA behörighet för schemat.

databricks schemas get FULL_NAME [flags]

Arguments

FULL_NAME

    Fullständigt namn på schemat.

Options

--include-browse

    Om du ska inkludera scheman i svaret som principalen endast kan komma åt begränsad metadata för.

Globala flaggor

Examples

I följande exempel hämtas information om ett schema:

databricks schemas get main.analytics

I följande exempel hämtas schemainformation, inklusive bläddrarbehörigheter:

databricks schemas get main.analytics --include-browse

lista över databricks-scheman

Visa en lista över scheman för en katalog i metaarkivet. Om anroparen är metaarkivadministratör eller ägare till den överordnade katalogen hämtas alla scheman för katalogen. Annars hämtas endast scheman som ägs av anroparen (eller som anroparen har behörighet för USE_SCHEMA ). Det finns ingen garanti för en specifik ordning på elementen i matrisen.

databricks schemas list CATALOG_NAME [flags]

Arguments

CATALOG_NAME

    Överordnad katalog för intressanta scheman.

Options

--include-browse

    Om du ska inkludera scheman i svaret som principalen endast kan komma åt begränsad metadata för.

--max-results int

    Maximalt antal scheman som ska returneras.

--page-token string

    Ogenomskinlig sidnumreringstoken för att gå till nästa sida baserat på föregående fråga.

Globala flaggor

Examples

I följande exempel listas alla scheman i katalogen main:

databricks schemas list main

I följande exempel visas scheman med högst 10 resultat:

databricks schemas list main --max-results 10

I följande exempel visas scheman med sidnumrering:

databricks schemas list main --page-token <token>

uppdatering av databricks-scheman

Uppdatera ett schema för en katalog. Anroparen måste vara ägare till schemat eller en metaarkivadministratör. Om anroparen är metaarkivadministratör kan endast fältet owner ändras i uppdateringen. Om fältet name måste uppdateras måste anroparen vara metaarkivadministratör eller ha behörighet för CREATE_SCHEMA den överordnade katalogen.

databricks schemas update FULL_NAME [flags]

Arguments

FULL_NAME

    Fullständigt namn på schemat.

Options

--comment string

    Beskrivning av text i fritt formulär som tillhandahålls av användaren.

--enable-predictive-optimization EnablePredictiveOptimization

    Om förutsägelseoptimering ska aktiveras för det här objektet och objekten under det. Värden som stöds: [INAKTIVERA, AKTIVERA, ÄRVA]

--json JSON

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

--new-name string

    Nytt namn på schemat.

--owner string

    Användarnamn för aktuell ägare av schemat.

Globala flaggor

Examples

I följande exempel uppdateras ett schemas kommentar:

databricks schemas update main.analytics --comment "Updated analytics schema"

I följande exempel ändras ägaren till ett schema:

databricks schemas update main.analytics --owner someone@example.com

I följande exempel byter du namn på ett schema:

databricks schemas update main.analytics --new-name analytics_v2

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