ALTER DATASET … ADD VERSION

Fügt eine Version zu einem Datensatz hinzu. Wenn Sie eine Version hinzufügen, können Sie Eigenschaften wie Partitionierung, Kommentare oder benutzerdefinierte Metadaten angeben.

Siehe auch:

ALTER DATASET, ALTER DATASET … DROP VERSION

Syntax

ALTER DATASET <name> ADD VERSION <version_name>
  FROM <select_statement>
  [ PARTITION BY <string_expr> ]
  [ COMMENT = <string_literal> ]
  [ METADATA = <json_string_literal> ]
Copy

Parameter

name

Der Name des Datensatzes, den Sie ändern möchten.

ADD VERSION version_name

Der Name der neuen Datensatzversion, die Sie erstellen.

FROM select_statement

Die SQL-Anweisung, die die Daten für die neue Datensatzversion definiert.

PARTITION BY string_expr

Der Partitionierungsausdruck für die neue Datensatzversion.

COMMENT = string_literal

Ein Kommentar für die neue Datensatzversion.

METADATA = json_string_literal

Eine JSON-Zeichenfolge mit Metadaten für die neue Datensatzversion. Im Folgenden finden Sie ein Beispiel für eine JSON-Zeichenfolge.

{"source": "my_table", "job_id": "123"}
Copy

Anforderungen an die Zugriffssteuerung

Eine Rolle, die zur Ausführung dieser Operation verwendet wird, muss mindestens die folgenden Berechtigungen haben:

Berechtigung

Objekt

Anmerkungen

OWNERSHIP

Datensatz

Bietet die Berechtigung, den Datensatz sowohl zu lesen als auch zu ändern.

USAGE-Berechtigung für die übergeordnete Datenbank und das Schema ist erforderlich, um Operationen an einem beliebigen Objekt in einem Schema durchzuführen.

Eine Anleitung zum Erstellen einer kundenspezifischen Rolle mit einer bestimmten Gruppe von Berechtigungen finden Sie unter Erstellen von kundenspezifischen Rollen.

Allgemeine Informationen zu Rollen und Berechtigungen zur Durchführung von SQL-Aktionen auf sicherungsfähigen Objekten finden Sie unter Übersicht zur Zugriffssteuerung.

Beispiele

Das folgende Beispiel fügt die Version v1 zum Datensatz abc mit Partitionierung hinzu:

ALTER DATASET abc
ADD VERSION 'v1' FROM (
    SELECT seq4() as ID, uniform(1, 10, random(721)) as PART
    FROM TABLE(GENERATOR(ROWCOUNT => 100000)) v)
PARTITION BY PART
COMMENT = 'Initial version'
METADATA = '{"source":"some_table","created_by":"analyst1"}';
Copy