Condividi tramite

shares gruppo di comandi

Note

Queste informazioni si applicano all'interfaccia della riga di comando di Databricks versione 0.205 e successive. L'interfaccia della riga di comando di Databricks è disponibile in anteprima pubblica.

L'uso della CLI di Databricks è soggetto alla Licenza di Databricks e all'Informativa sulla privacy di Databricks, incluse eventuali disposizioni sui dati di utilizzo.

Il shares gruppo di comandi all'interno dell'interfaccia della riga di comando di Databricks consente di gestire le condivisioni in Unity Catalog.

Una condivisione è un contenitore di cui viene creata un'istanza con shares create. Dopo aver creato è possibile registrare in modo iterativo una raccolta di asset di dati esistenti definiti all'interno del metastore usando shares update. È possibile registrare gli asset di dati con il nome originale, qualificato dal relativo schema originale o specificare nomi esposti alternativi.

Creazione di condivisioni di databricks

Creare una nuova condivisione per gli oggetti dati. Gli oggetti dati possono essere aggiunti dopo la creazione con update. Il chiamante deve essere un amministratore del metastore o avere il CREATE_SHARE privilegio sul metastore.

databricks shares create NAME [flags]

Arguments

NAME

    Nome della condivisione.

Options

--comment string

    Descrizione di testo in formato libero fornita dall'utente.

--json JSON

    Stringa JSON inline o file JSON @path con il corpo della richiesta.

--storage-root string

    URL radice di archiviazione per i file del notebook nella condivisione.

Flag globali

Examples

Gli esempi seguenti creano una condivisione denominata my-analytics-share con un commento:

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

L'esempio seguente crea una condivisione con una radice di archiviazione specifica:

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

eliminare le condivisioni di Databricks

Eliminare una condivisione dal metastore. Il chiamante deve essere un proprietario della condivisione.

databricks shares delete NAME [flags]

Arguments

NAME

    Nome della condivisione.

Options

Flag globali

Examples

Nell'esempio seguente viene eliminata una condivisione denominata my-analytics-share:

databricks shares delete my-analytics-share

le condivisioni di databricks ottengono

Ottenere una quota dal metastore. Il chiamante deve essere un amministratore del metastore o il proprietario della condivisione.

databricks shares get NAME [flags]

Arguments

NAME

    Nome della condivisione.

Options

--include-shared-data

    Eseguire una query per includere i dati nella condivisione.

Flag globali

Examples

Nell'esempio seguente vengono recuperate informazioni su una condivisione denominata my-analytics-share:

databricks shares get my-analytics-share

Il seguente esempio mostra una condivisione con informazioni sui dati condivisi.

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

(Deprecato) elenco di condivisioni Databricks

Deprecated. Elencare le condivisioni dal metastore. Il chiamante deve essere un amministratore del metastore o il proprietario della condivisione. L'ordine degli elementi nella matrice non è garantito.

databricks shares list [flags]

Arguments

None

Options

--max-results int

    Numero massimo di condivisioni da restituire.

--page-token string

    Token di paginazione non trasparente per passare alla pagina successiva in base alla query precedente.

Flag globali

databricks elenco-condivisioni

Elencare le condivisioni dal metastore. Il chiamante deve essere un amministratore del metastore o il proprietario della condivisione. L'ordine degli elementi nella matrice non è garantito.

databricks shares list-shares [flags]

Arguments

None

Options

--max-results int

    Numero massimo di condivisioni da restituire.

--page-token string

    Token di paginazione non trasparente per passare alla pagina successiva in base alla query precedente.

Flag globali

Examples

Nell'esempio seguente sono elencate tutte le condivisioni:

databricks shares list-shares

aggiornamento delle condivisioni di databricks

Aggiorna la condivisione con le modifiche al contenuto e gli oggetti dati nella richiesta di aggiornamento. Il chiamante deve essere il proprietario della condivisione o un amministratore del metastore.

Quando il chiamante è un amministratore del metastore, è possibile aggiornare solo il owner campo.

Nel caso in cui il nome della condivisione venga modificato, updateShare richiede che il chiamante sia il proprietario della condivisione e abbia il CREATE_SHARE privilegio .

Se nella condivisione sono presenti file di notebook, il storage_root campo non può essere aggiornato.

Per ogni tabella aggiunta tramite questo metodo, anche il proprietario della condivisione deve avere SELECT privilegio di condivisione sulla tabella. Questo privilegio deve essere mantenuto a tempo indeterminato per consentire ai destinatari di accedere alla tabella. In genere, è consigliabile usare un gruppo come proprietario della condivisione.

Le rimozioni di tabelle tramite update non richiedono privilegi aggiuntivi.

databricks shares update NAME [flags]

Arguments

NAME

    Nome della condivisione.

Options

--comment string

    Descrizione di testo in formato libero fornita dall'utente.

--json JSON

    Stringa JSON inline o file JSON @path con il corpo della richiesta.

--new-name string

    Nuovo nome per la condivisione.

--owner string

    Nome utente del proprietario corrente della condivisione.

--storage-root string

    URL radice di archiviazione per i file del notebook nella condivisione.

Flag globali

Examples

L'esempio seguente aggiorna il commento di una condivisione:

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

Nell'esempio seguente viene modificato il nome di una condivisione:

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

L'esempio seguente aggiorna il proprietario di una condivisione:

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

L'esempio seguente aggiorna una condivisione usando la configurazione JSON:

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

databricks condivide le autorizzazioni di condivisione

Ottenere le autorizzazioni per una condivisione dati dal metastore. Il chiamante deve essere un amministratore del metastore o il proprietario della condivisione.

databricks shares share-permissions NAME [flags]

Arguments

NAME

    Nome della condivisione.

Options

--max-results int

    Numero massimo di autorizzazioni da restituire.

--page-token string

    Token di paginazione non trasparente per passare alla pagina successiva in base alla query precedente.

Flag globali

Examples

L'esempio seguente ottiene le autorizzazioni per una condivisione denominata my-analytics-share:

databricks shares share-permissions my-analytics-share

databricks condivide le autorizzazioni di aggiornamento

Aggiornare le autorizzazioni per una condivisione dati nel metastore. Il chiamante deve essere un amministratore del metastore o un proprietario della condivisione.

Per le concessioni di nuovi destinatari, l'utente deve anche essere il proprietario del destinatario o l'amministratore del metastore. Le revoche dei destinatari non richiedono privilegi aggiuntivi.

databricks shares update-permissions NAME [flags]

Arguments

NAME

    Nome della condivisione.

Options

--json JSON

    Stringa JSON inline o file JSON @path con il corpo della richiesta.

--omit-permissions-list

    Optional.

Flag globali

Examples

L'esempio seguente concede le autorizzazioni a un destinatario:

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

L'esempio seguente revoca le autorizzazioni a un destinatario:

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

Bandiere globali

--debug

  Indica se abilitare la registrazione di debug.

-h oppure --help

    Mostra la guida per il Databricks CLI, il gruppo di comandi correlato o il comando correlato.

--log-file stringa

    Stringa che rappresenta il file in cui scrivere i log di output. Se questo flag non viene specificato, l'impostazione predefinita prevede la scrittura dei log di output su stderr.

--log-format formato

    Tipo di formato del log, text o json. Il valore predefinito è text.

--log-level stringa

    Stringa che rappresenta il livello di formato del log. Se non specificato, il livello di formato del log è disabilitato.

tipo

    Tipo di output del comando, text o json. Il valore predefinito è text.

-p, --profile stringa

    Nome del profilo nel ~/.databrickscfg file da usare per eseguire il comando . Se questo flag non viene specificato, se esiste, viene usato il profilo denominato DEFAULT .

--progress-format formato

    Formato per visualizzare i log di stato: default, append, inplaceo json

-t, --target stringa

    Se applicabile, la destinazione del bundle da utilizzare

  • Last updated on