Grupo de comandos shares

O shares grupo de comandos dentro da CLI do Databricks permite que você gerencie compartilhamentos no Catálogo do Unity.

Um compartilhamento é um contêiner instanciado com shares create. Depois de criado, você pode registrar iterativamente uma coleção de ativos de dados existentes definidos no metastore usando shares update. Você pode registrar ativos de dados em seu nome original, qualificados pelo esquema original ou fornecer nomes expostos alternativos.

Criar compartilhamentos do Databricks

Crie um novo compartilhamento para objetos de dados. Objetos de dados podem ser adicionados após a criação com update. O chamador deve ser um administrador do metastore ou ter o CREATE_SHARE privilégio no metastore.

databricks shares create NAME [flags]

Arguments

NAME

    Nome do compartilhamento.

Opções

--comment string

    Descrição do texto de forma livre fornecida pelo usuário.

--json JSON

    A cadeia de caracteres JSON inserida em linha ou o @path para o arquivo JSON com o corpo da solicitação.

--storage-root string

    URL raiz de armazenamento para arquivos de notebook no compartilhamento.

Sinalizadores globais

Examples

Os exemplos a seguir criam um compartilhamento nomeado my-analytics-share com um comentário:

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

O exemplo a seguir cria um compartilhamento com uma raiz de armazenamento específica:

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

exclusão de compartilhamentos do databricks

Exclua um compartilhamento do metastore. O chamador deve ser um proprietário do compartilhamento.

databricks shares delete NAME [flags]

Arguments

NAME

    O nome do compartilhamento.

Opções

Sinalizadores globais

Examples

O exemplo a seguir exclui um compartilhamento chamado my-analytics-share:

databricks shares delete my-analytics-share

obter ações da Databricks

Obtenha um compartilhamento do metastore. O chamador deve ser um administrador metastore ou o proprietário do compartilhamento.

databricks shares get NAME [flags]

Arguments

NAME

    O nome do compartilhamento.

Opções

--include-shared-data

    Consulte os dados a serem incluídos no compartilhamento.

Sinalizadores globais

Examples

O exemplo a seguir obtém informações sobre um compartilhamento chamado my-analytics-share:

databricks shares get my-analytics-share

O exemplo a seguir mostra um compartilhamento com detalhes sobre os dados compartilhados:

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

Lista de compartilhamentos de dados do Databricks (obsoleto)

Preterido. Listar compartilhamentos do metastore. O chamador deve ser um administrador metastore ou o proprietário do compartilhamento. A ordem dos elementos na matriz não é garantida.

databricks shares list [flags]

Arguments

None

Opções

--max-results int

    Número máximo de compartilhamentos a serem retornados.

--page-token string

    Token de paginação não transparente que permite ir para a próxima página com base na consulta anterior.

Sinalizadores globais

compartilhamentos de databricks list-shares

Listar compartilhamentos do metastore. O chamador deve ser um administrador metastore ou o proprietário do compartilhamento. A ordem dos elementos na matriz não é garantida.

databricks shares list-shares [flags]

Arguments

None

Opções

--max-results int

    Número máximo de compartilhamentos a serem retornados.

--page-token string

    Token de paginação não transparente que permite ir para a próxima página com base na consulta anterior.

Sinalizadores globais

Examples

O exemplo a seguir lista todos os compartilhamentos:

databricks shares list-shares

atualização de ações da Databricks

Atualize o compartilhamento incorporando as alterações e os objetos de dados contidos na solicitação. O chamador deve ser o proprietário do compartilhamento ou um administrador de metastore.

Quando o chamador é um administrador do metastore, somente o owner campo pode ser atualizado.

No caso de o nome do compartilhamento ser alterado, updateShare requer que o chamador seja o proprietário do compartilhamento e tenha o CREATE_SHARE privilégio.

Se houver arquivos de notebook no compartilhamento, o storage_root campo não poderá ser atualizado.

Para cada tabela adicionada por este método, o proprietário do compartilhamento também deve ter o privilégio SELECT sobre a tabela. Esse privilégio deve ser mantido indefinidamente para que os destinatários possam acessar a tabela. Normalmente, é recomendável utilizar um grupo como proprietário do compartilhamento.

Remoções de tabela através de update não exigem privilégios adicionais.

databricks shares update NAME [flags]

Arguments

NAME

    O nome do compartilhamento.

Opções

--comment string

    Descrição do texto de forma livre fornecida pelo usuário.

--json JSON

    A cadeia de caracteres JSON inserida em linha ou o @path para o arquivo JSON com o corpo da solicitação.

--new-name string

    Novo nome para o compartilhamento.

--owner string

    Nome de usuário do proprietário atual do compartilhamento.

--storage-root string

    URL raiz de armazenamento para arquivos de notebook no compartilhamento.

Sinalizadores globais

Examples

O seguinte exemplo atualiza o comentário de um compartilhamento:

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

O exemplo a seguir altera o nome de um compartilhamento:

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

O seguinte exemplo atualiza o proprietário de um compartilhamento:

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

O exemplo a seguir atualiza um compartilhamento usando a configuração JSON:

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

databricks compartilha permissões de compartilhamento

Obtenha permissões para um compartilhamento de dados do metastore. O chamador deve ser um administrador metastore ou o proprietário do compartilhamento.

databricks shares share-permissions NAME [flags]

Arguments

NAME

    O nome do compartilhamento.

Opções

--max-results int

    Número máximo de permissões a serem retornadas.

--page-token string

    Token de paginação não transparente que permite ir para a próxima página com base na consulta anterior.

Sinalizadores globais

Examples

O exemplo a seguir obtém permissões para um compartilhamento chamado my-analytics-share:

databricks shares share-permissions my-analytics-share

databricks compartilha permissões de atualização

Atualize as permissões para um compartilhamento de dados no metastore. O chamador deve ser um administrador do metastore ou um proprietário do compartilhamento.

Para novas concessões a destinatários, o usuário também deve ser o proprietário do destinatário ou administrador do metastore. As revogações de destinatários não exigem privilégios adicionais.

databricks shares update-permissions NAME [flags]

Arguments

NAME

    O nome do compartilhamento.

Opções

--json JSON

    A cadeia de caracteres JSON inserida em linha ou o @path para o arquivo JSON com o corpo da solicitação.

--omit-permissions-list

    Optional.

Sinalizadores globais

Examples

O exemplo a seguir concede permissões a um destinatário:

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

O exemplo a seguir revoga permissões de um destinatário:

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

Sinalizadores globais

--debug

  Indica se deve habilitar o registro em log de depuração.

-h ou --help

    Exiba ajuda para a CLI do Databricks ou o grupo de comandos relacionado ou o comando relacionado.

--log-file corda

    Uma cadeia de caracteres que representa o arquivo para o qual gravar logs de saída. Se esse sinalizador não for especificado, o padrão será gravar logs de saída no stderr.

--log-format formato

    O tipo de formato de log, text ou json. O valor padrão é text.

--log-level corda

    Uma cadeia de caracteres que representa o nível de formato de log. Se não for especificado, o nível de formato de log será desabilitado.

-o, --output tipo

    O tipo de saída de comando, text ou json. O valor padrão é text.

-p, --profile corda

    O nome do perfil no arquivo ~/.databrickscfg para usar ao executar o comando. Se esse sinalizador não for especificado, se existir, o perfil nomeado DEFAULT será usado.

--progress-format formato

    O formato para exibir logs de progresso: default, append, inplace ou json

-t, --target corda

    Se aplicável, o destino do pacote a ser usado