CREATE SHARE

  • Artikel

Gilt für:Häkchen ja Databricks SQL durch Häkchen mit „Ja“ markiert Databricks Runtime 10.4 LTS und höher Häkchen bei ja nur für Unity Catalog

Erstellt eine Freigabe mit dem angegebenen Namen. Wenn bereits eine Freigabe mit demselben Namen vorhanden ist, wird eine Ausnahme ausgelöst.

Um eine Freigabe zu erstellen, müssen Sie ein Metastore-Administrator sein oder die CREATE SHARE-Berechtigung für den Unity Catalog-Metastore haben, in dem die freizugebenden Daten registriert sind.

Verwenden Sie ALTER SHARE zum Hinzufügen von Inhalten zur Freigabe.

Syntax

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

Parameter

  • share_name

    Name der Dateifreigabe, die erstellt werden soll.

  • IF NOT EXISTS

    Erstellt eine Freigabe mit dem angegebenen Namen, wenn sie nicht vorhanden ist. Wenn bereits eine Freigabe mit demselben Namen vorhanden ist, geschieht nichts.

  • Kommentar

    Ein optionales STRING-Literal. Beschreibung für die Freigabe.

Beispiele

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