Partager via

CREATE SHARE

  • Article

S’applique à : coche marquée oui Databricks SQL coche marquée oui Databricks Runtime 10.4 LTS et ultérieur coche pour oui Unity Catalog uniquement

Crée un partage du nom spécifié. S’il existe déjà un partage du même nom, une exception est levée.

Pour créer un partage, vous devez être administrateur de metastore ou avoir le privilège CREATE SHARE sur le metastore Unity Catalog où sont inscrites les données à partager.

Pour ajouter du contenu au partage, utilisez ALTER SHARE.

Syntaxe

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

Paramètres

  • share_name

    Nom du partage à créer.

  • IF NOT EXISTS

    Crée un partage du nom spécifié s’il n’en existe pas. S’il existe déjà un partage du même nom, rien ne se produit.

  • comment

    Littéral STRING facultatif. Description du partage.

Exemples

-- 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';