Partilhar via


CREATE SHARE

Aplica-se a:assinalado sim Databricks SQL assinalado sim Databricks Runtime 10.4 LTS e versões superiores assinalado sim somente Unity Catalog

Cria um compartilhamento com o nome especificado. Se já existir uma partilha com o mesmo nome, gera-se uma exceção.

Para criar um compartilhamento, você deve ser um administrador de metastore ou ter o CREATE SHARE privilégio para o metastore do Unity Catalog onde os dados que você deseja compartilhar estão registrados.

Para adicionar conteúdo ao compartilhamento, use ALTER SHARE.

Sintaxe

CREATE SHARE [ IF NOT EXISTS ] share_name
    [ COMMENT comment ]

Parâmetros

  • share_name

    O nome da partilha a ser criada.

  • SE NÃO EXISTIR

    Cria um compartilhamento com o nome próprio, se ele não existir. Se já existir uma partilha com o mesmo nome, nada acontecerá.

  • comentar

    Um literal opcional STRING. A descrição do compartilhamento.

Exemplos

-- Create share `customer_share`. This throws exception if a share with name customer_share
-- already exists.
> CREATE SHARE customer_share;

-- Create share `customer_share` only if share with same name doesn't exist.
> CREATE SHARE IF NOT EXISTS customer_share;

-- Create share `customer_share` only if share with same name doesn't exist, with a comment.
> CREATE SHARE IF NOT EXISTS customer_share COMMENT 'This is customer share';