shares kommandogrupp

The shares command group within the Databricks CLI allows you to manage shares in Unity Catalog.

En resurs är en container som instansieras med shares create. När du har skapat kan du iterativt registrera en samling befintliga datatillgångar som definierats i metaarkivet med hjälp av shares update. Du kan registrera datatillgångar under deras ursprungliga namn, kvalificeras av deras ursprungliga schema eller ange alternativa exponerade namn.

skapa databricks-resurser

Skapa en ny resurs för dataobjekt. Dataobjekt kan läggas till när de har skapats med update. Anroparen måste vara metaarkivadministratör eller ha behörighet för CREATE_SHARE metaarkivet.

databricks shares create NAME [flags]

Arguments

NAME

    Resursens namn.

Options

--comment string

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

--json JSON

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten.

--storage-root string

    Lagringsrot-URL för resursen.

Global flags

Examples

I följande exempel skapas en resurs med namnet my-analytics-share med en kommentar:

databricks shares create my-analytics-share --comment "Sales analytics data share"

I följande exempel skapas en resurs med en specifik lagringsrot:

databricks shares create my-analytics-share --storage-root "s3://my-bucket/share-data"

ta bort databricks-resurser

Ta bort en resurs från metaarkivet. Anroparen måste vara ägare till resursen.

databricks shares delete NAME [flags]

Arguments

NAME

    Namnet på resursen.

Options

Global flags

Examples

I följande exempel tas en resurs med namnet my-analytics-share:

databricks shares delete my-analytics-share

databricks-resurser får

Hämta en resurs från metaarkivet. Anroparen måste vara metaarkivadministratör eller ägare till resursen.

databricks shares get NAME [flags]

Arguments

NAME

    Namnet på resursen.

Options

--include-shared-data

    Fråga efter data som ska ingå i resursen.

Global flags

Examples

I följande exempel hämtas information om en resurs med namnet my-analytics-share:

databricks shares get my-analytics-share

I följande exempel hämtas en resurs med information om delade data:

databricks shares get my-analytics-share --include-shared-data

databricks-resurslista

Visa en lista över resurser från metaarkivet. Anroparen måste vara metaarkivadministratör eller ägare till resursen. Det finns ingen garanti för en specifik ordning på elementen i matrisen.

databricks shares list [flags]

Arguments

None

Options

--max-results int

    Maximalt antal resurser som ska returneras.

--page-token string

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

Global flags

Examples

I följande exempel visas alla resurser:

databricks shares list

uppdatering av databricks-resurser

Uppdatera resursen med ändringarna och dataobjekten i begäran. Anroparen måste vara ägare till resursen eller en metaarkivadministratör.

När anroparen är metaarkivadministratör kan endast fältet owner uppdateras.

Om resursnamnet ändras updateShare kräver det att anroparen är ägare till resursen och har behörigheten CREATE_SHARE .

Om det finns notebook-filer i resursen går det inte att uppdatera fältet storage_root .

För varje tabell som läggs till via den här metoden måste resursägaren också ha SELECT behörighet i tabellen. Den här behörigheten måste behållas på obestämd tid för att mottagarna ska kunna komma åt tabellen. Vanligtvis bör du använda en grupp som resursägare.

Tabellborttagningar via update kräver inte ytterligare behörigheter.

databricks shares update NAME [flags]

Arguments

NAME

    Namnet på resursen.

Options

--comment string

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

--json JSON

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten.

--new-name string

    Nytt namn på resursen.

--owner string

    Användarnamn för den aktuella ägaren av resursen.

--storage-root string

    Lagringsrot-URL för resursen.

Global flags

Examples

I följande exempel uppdateras en resurs kommentar:

databricks shares update my-analytics-share --comment "Updated sales analytics data share"

I följande exempel ändras en resurss namn:

databricks shares update my-analytics-share --new-name "sales-analytics-share"

I följande exempel uppdateras en resurss ägare:

databricks shares update my-analytics-share --owner "someone@example.com"

I följande exempel uppdateras en resurs med JSON-konfiguration:

databricks shares update my-analytics-share --json '{
  "comment": "Updated share with new tables",
  "objects": [
    {
      "name": "sales.customers",
      "data_object_type": "TABLE"
    }
  ]
}'

databricks delar resursbehörigheter

Hämta behörigheter för en dataresurs från metaarkivet. Anroparen måste vara metaarkivadministratör eller ägare till resursen.

databricks shares share-permissions NAME [flags]

Arguments

NAME

    Namnet på resursen.

Options

--max-results int

    Maximalt antal behörigheter som ska returneras.

--page-token string

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

Global flags

Examples

I följande exempel hämtas behörigheter för en resurs med namnet my-analytics-share:

databricks shares share-permissions my-analytics-share

databricks delar uppdateringsbehörigheter

Uppdatera behörigheterna för en dataresurs i metaarkivet. Anroparen måste vara metaarkivadministratör eller ägare till resursen.

För nya mottagarbidrag måste användaren också vara mottagarens ägare eller metaarkivadministratör. Återkallningar av mottagare kräver inte ytterligare behörigheter.

databricks shares update-permissions NAME [flags]

Arguments

NAME

    Namnet på resursen.

Options

--json JSON

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten.

--omit-permissions-list

    Optional.

Global flags

Examples

I följande exempel ges behörigheter till en mottagare:

databricks shares update-permissions my-analytics-share --json '{
  "changes": [
    {
      "principal": "recipient-name",
      "add": ["SELECT"]
    }
  ]
}'

I följande exempel återkallas behörigheter från en mottagare:

databricks shares update-permissions my-analytics-share --json '{
  "changes": [
    {
      "principal": "recipient-name",
      "remove": ["SELECT"]
    }
  ]
}'

Global flags

--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 eller textjson. 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 filen som ~/.databrickscfg 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