Kategorien:

DDL für Datenbanken, Schemas und Freigaben

ALTER SHARE

Ändert die Eigenschaften für eine vorhandene Freigabe:

  • Fügt Konten hinzu oder entfernt sie aus der Liste der Konten.

  • Legt eine neue Liste von Konten fest, für die die zur Freigabe gehörende Datenbank freigegeben ist.

  • Ändert andere Eigenschaften. Details zu den Parametern finden Sie unter Parameter.

Siehe auch:

CREATE SHARE, DESCRIBE SHARE, SHOW SHARES

Syntax

ALTER SHARE [ IF EXISTS ] <name> { ADD | REMOVE } ACCOUNTS = <consumer_account> [ , <consumer_account> , ... ]
                                        [ SHARE_RESTRICTIONS = { TRUE | FALSE } ]

ALTER SHARE [ IF EXISTS ] <name>  ADD ACCOUNTS = <consumer_account> [ , <consumer_account> , ... ]
                                        [ SHARE_RESTRICTIONS = { TRUE | FALSE } ]

ALTER SHARE [ IF EXISTS ] <name> SET { [ ACCOUNTS = <consumer_account> [ , <consumer_account> ... ] ]
                                       [ COMMENT = '<string_literal>' ] }

ALTER SHARE [ IF EXISTS ] <name> UNSET COMMENT

Parameter

Name

Gibt den Bezeichner für die zu ändernde Freigabe an. Wenn der Bezeichner Leerzeichen oder Sonderzeichen enthält, muss die gesamte Zeichenfolge in doppelte Anführungszeichen gesetzt werden. Bei Bezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, ist auch die Groß- und Kleinschreibung zu beachten.

ADD | REMOVE ACCOUNTS = Verbraucherkonto [ , Verbraucherkonto , ... ]

Gibt die Namen der Konten an, die der Liste der Konten für die Freigabe hinzugefügt oder daraus entfernt werden sollen:

  • Das Hinzufügen eines Kontos zu einer Freigabe, die bereits in der Liste war, hat keine Auswirkung.

  • Wenn Sie ein Konto entfernen, das bereits die gemeinsame Datenbank importiert hat, wird der Zugriff dieses Kontos auf die Datenbank sofort widerrufen. Wenn das Konto später wieder der Freigabe hinzugefügt wird, muss das Konto die Datenbank neu erstellen, bevor es sie wieder verwenden kann.

  • Das Entfernen eines Kontos von einer Freigabe, das nicht bereits in der Liste der freigegebenen Konten enthalten war, hat keine Auswirkung.

Dieser Parameter fügt Konten zur vorhandenen Liste der Konten für die Freigabe hinzu (oder entfernt sie daraus). Wenn Sie die gesamte Liste der Konten ersetzen möchten, verwenden Sie stattdessen SET.

SHARE_RESTRICTIONS = TRUE | FALSE

Aktiviert/deaktiviert das Hinzufügen eines Standard- oder Enterprise-Verbraucherkontos zu einer Freigabe, die einem Business Critical-Datenanbieter gehört.

Wichtig

Sie müssen diesen Parameter jedes Mal festlegen, wenn Sie der Freigabe eines Business Critical-Anbieters ein neues Nicht-Business Critical-Verbraucherkonto hinzufügen. Weitere Informationen dazu finden Sie unter Aktivieren von Freigaben eines Business Critical-Konto für ein Nicht-Business Critical-Konto.

SET...

ACCOUNTS = Verbraucherkonto [ , Verbraucherkonto ... ]

Gibt das/die Konto(en) an, um alle vorherigen Konten, mit denen die Freigabe geteilt wurde, zu ersetzen. Um einzelne Konten aus der Liste hinzuzufügen/daraus zu entfernen, verwenden Sie stattdessen ADD | REMOVE.

COMMENT = 'Zeichenfolge'

Fügt einen Kommentar hinzu oder überschreibt einen bestehenden Kommentar für die Freigabe.

UNSET ...

Gibt die Eigenschaften an, die für die Freigabe deaktiviert werden sollen, wodurch sie auf die Standardwerte zurückgesetzt werden.

Derzeit können Sie nur die Eigenschaft COMMENT deaktivieren, die den Kommentar, falls vorhanden, für die Freigabe entfernt.

Nutzungshinweise

  • Nur die ACCOUNTADMIN-Rolle hat die Berechtigung, eine Freigabe zu ändern. Wenn Sie diesen Befehl mit einer anderen Rolle als ACCOUNTADMIN ausführen, wird ein Fehler ausgegeben.

  • Die Schlüsselwörter ACCOUNT und ACCOUNTS werden beide unterstützt und können austauschbar verwendet werden.

Beispiele

Hinzufügen von zwei Konten zu einer vorhandenen Freigabe namens sales_s:

ALTER SHARE sales_s ADD ACCOUNTS=xy12345,yz23456;

+----------------------------------+
| status                           |
|----------------------------------|
| Statement executed successfully. |
+----------------------------------+

Entfernen von Konto yz23456 aus sales_s:

ALTER SHARE sales_s REMOVE ACCOUNT=yz23456;

+----------------------------------+
| status                           |
|----------------------------------|
| Statement executed successfully. |
+----------------------------------+

Hinzufügen eines neuen Kommentars zu sales_s:

ALTER SHARE sales_s SET COMMENT='This share contains sales data for 2017';

+----------------------------------+
| status                           |
|----------------------------------|
| Statement executed successfully. |
+----------------------------------+