CREATE DATABASE (katalogverknüpft)¶

Erstellt eine neue Katalogverknüpfte Datenbank für Apache Iceberg™-Tabellen, die einen externen Iceberg REST-Katalog verwenden.

Syntax¶

CREATE DATABASE <name>
  LINKED_CATALOG = ( catalogParams ),
  [ EXTERNAL_VOLUME = '<external_vol>' ]
  [ COMMENT = '<string_literal>' ]
  [ [ WITH ] TAG ( <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' , ... ] ) ]

Copy

Wobei:

catalogParams ::=
  CATALOG = '<catalog_int>',
  [ ALLOWED_NAMESPACES = ('<namespace1>', '<namespace2>', ... ) ]
  [ BLOCKED_NAMESPACES = ('<namespace1>', '<namespace2>', ... ) ]
  [ NAMESPACE_MODE = { IGNORE_NESTED_NAMESPACE | FLATTEN_NESTED_NAMESPACE } ]
  [ NAMESPACE_FLATTEN_DELIMITER = '<string_literal>' ]
  [ SYNC_INTERVAL_SECONDS = <value> ]

Copy

Erforderliche Parameter¶

name

Gibt den Bezeichner für die katalogverknüpfte Datenbank an. Dieser muss für Ihr Konto eindeutig sein.

Darüber hinaus muss der Bezeichner mit einem Buchstaben beginnen und darf keine Leer- oder Sonderzeichen enthalten, es sei denn, die gesamte Bezeichnerzeichenfolge wird in doppelte Anführungszeichen gesetzt (z. B. "My object"). Bei Bezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, ist auch die Groß-/Kleinschreibung zu beachten.

Weitere Informationen dazu finden Sie unter Anforderungen an Bezeichner.

Optionale Parameter¶

EXTERNAL_VOLUME = my_external_vol

Gibt ein Externes Volumen an, das den Zugriff auf die Daten und Metadaten Ihrer externen Iceberg-Tabellen ermöglicht.

Nicht erforderlich bei Verwendung von Anmeldeinformationen.

COMMENT = 'string_literal'

Gibt einen Kommentar für die Datenbank an.

Standard: Kein Wert

TAG ( tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ] )

Gibt den Namen des Tags und den Wert der Tag-Zeichenfolge an.

Der Tag-Wert ist immer eine Zeichenfolge, die maximale 256 Zeichen lang sein kann.

Weitere Informationen zur Angabe von Tags in einer Anweisung finden Sie unter Tag-Kontingent für Objekte.

Katalogparameter (catalogParams)¶

CATALOG = catalog_int

Gibt den Namen Ihrer Katalogintegration an.

ALLOWED_NAMESPACES = ('namespace1', 'namespace2', ... )

Gibt optional einen oder mehrere Namespaces in Ihrem Remote-Katalog an, um den Bereich der automatischen Tabellenerkennung einzuschränken. Snowflake synchronisiert die angegebenen Namespaces und alle Namespaces und Tabellen, die von diesen abhängen. Wenn ein verschachtelter Namespace in der ALLOWED_NAMESPACES Liste enthalten ist, Sie jedoch den NAMESPACE_MODE-Parameter auf IGNORE_NESTED_NAMESPACE setzen, synchronisiert Snowflake weder den verschachtelten Namespace noch die darunter liegenden Schemata und Tabellen.

BLOCKED_NAMESPACES = ('namespace1', 'namespace2', ... )

Gibt optional einen oder mehrere Namespaces in Ihrem Remote-Katalog an, die für die automatische Tabellenerkennung gesperrt werden sollen.

Snowflake blockiert die angegebenen Namespaces und alle Namespaces und Tabellen, die von ihnen abhängen.

Wenn Sie sowohl ALLOWED_NAMESPACES als auch BLOCKED_NAMESPACES angeben, dann hat dieBLOCKED_NAMESPACES-Liste Vorrang. Beispiel: Wenn ns1.ns2 erlaubt ist, aber ns1 blockiert ist, dann wird Snowflake nicht synchronisiert ns1.ns2.

NAMESPACE_MODE = { IGNORE_NESTED_NAMESPACE | FLATTEN_NESTED_NAMESPACE }

Gibt an, wie Snowflake Namespaces für Iceberg-Tabellen in der katalogverknüpften Datenbank behandelt.

IGNORE_NESTED_NAMESPACE: Snowflake verknüpft nur Tabellen in der ersten Namespace-Ebene für Ihren Katalog.
FLATTEN_NESTED_NAMESPACE: Snowflake verknüpft Tabellen in allen Namespace-Ebenen für Ihren Katalog. Für eine Tabelle in einem verschachtelten Namespace verwendet Snowflake die NAMESPACE_FLATTEN_DELIMITER-Parameter, um einen vereinfachten Namespace zu erstellen. Mit dieser Option müssen Sie die NAMESPACE_FLATTEN_DELIMITER-Parameter einstellen.

Betrachten Sie beispielsweise eine Tabelle mit dem Namen iceberg_table_5 im namespace3aa-Namespace:
```
my_catalog_linked_db
|-- namespace3
|   |-- namespace3a
|       |-- namespace3aa
|           |-- iceberg_table_5
```
Copy
Wenn Sie NAMESPACE_FLATTEN_DELIMITER = "/" einstellen, können Sie "my_catalog_linked_db"."namespace3/namespace3a/namespace3aa"."iceberg_table_5" angeben, um auf die Tabelle zu verweisen.

Standard: IGNORE_NESTED_NAMESPACE

NAMESPACE_FLATTEN_DELIMITER = 'string_literal'

Erforderlich, wenn Sie NAMESPACE_MODE = FLATTEN_NESTED_NAMESPACE einstellen. Gibt ein Trennzeichen an, das Snowflake verwendet, um vereinfachte Namespaces für Tabellen in Ihrem Katalog zu konstruieren.

Wichtig

Das Zeichen, das Sie als Trennzeichen wählen, darf nicht in Ihren entfernten Namespaces erscheinen. Während des automatischen Erkennungsprozesses überspringt Snowflake jeden Namespace, der das Trennzeichen enthält, und erstellt kein entsprechendes Schema in Ihrer mit dem Katalog verbundenen Datenbank.

Gültige Zeichen: Alle in Snowflake-Bezeichnern erlaubten Zeichen.

SYNC_INTERVAL_SECONDS = 'value'

Gibt das Zeitintervall (in Sekunden) an, das Snowflake für die automatische Erkennung von Schemas und Tabellen in Ihrem Remote-Katalog verwenden soll.

Werte: 30 bis 86.400 (1 Tag), einschließlich

Standard: 30 Sekunden.

Anforderungen an die Zugriffssteuerung¶

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

Berechtigung	Objekt	Anmerkungen
CREATE DATABASE	Konto	Erforderlich, um eine neue Datenbank zu erstellen. Only the SYSADMIN role, or a higher role, has this privilege by default. The privilege can be granted to additional roles as needed.
USAGE	Externes Volume	Erforderlich, um auf ein vorhandenes externes Volume zu verweisen.
USAGE	Katalogintegration	Erforderlich, um auf eine bestehende Katalogintegration zu verweisen.

Berechtigung

Objekt

Anmerkungen

CREATE DATABASE

Konto

Erforderlich, um eine neue Datenbank zu erstellen.

Only the SYSADMIN role, or a higher role, has this privilege by default. The privilege can be granted to additional roles as needed.

USAGE

Externes Volume

Erforderlich, um auf ein vorhandenes externes Volume zu verweisen.

USAGE

Katalogintegration

Erforderlich, um auf eine bestehende Katalogintegration zu verweisen.

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.

Nutzungshinweise¶

Für ALLOWED_NAMESPACES und BLOCKED_NAMESPACES speichert Snowflake keine verschachtelten Namespaces, wenn das Set bereits den übergeordneten Namespace enthält. Wenn Sie beispielsweise eine Datenbank erstellen und ALLOWED_NAMESPACES = ('ns1', 'ns1.ns2', 'ns1.ns3') angeben, dann speichert Snowflake nur ns1, da die anderen beiden automatisch enthalten sind. Wenn Sie GET_DDL auf der Beispieldatenbank verwenden, gibt Snowflake ALLOWED_NAMESPACES = ('ns1') zurück. Dasselbe gilt für BLOCKED_NAMESPACES.
Beim Abfragen von Tabellen in einer mit dem Katalog verbundenen Datenbank:
- Snowflake konvertiert Bezeichner ohne Anführungszeichen (Tabellen- und Spaltennamen) automatisch in Großbuchstaben. Wenn Ihr externer Iceberg-Katalog Bezeichner verwendet, bei denen die Groß-/Kleinschreibung beachtet wird, müssen Sie Tabellen- und Spaltennamen in doppelte Anführungszeichen setzen.
  
  Weitere Informationen zu Kontobezeichnern finden Sie unter Anforderungen an Bezeichner.
Metadaten:

Achtung

Kunden müssen sicherstellen, dass bei der Nutzung des Snowflake-Dienstes keine personenbezogenen Daten (außer für ein Objekt „User“), sensible Daten, exportkontrollierte Daten oder andere regulierte Daten als Metadaten eingegeben werden. Weitere Informationen dazu finden Sie unter Metadatenfelder in Snowflake.

Beispiele¶

Erstellen Sie eine katalogverknüpfte Datenbank mit verschachtelten Namespaces (Flattening).

CREATE DATABASE my_linked_db
  LINKED_CATALOG = (
    CATALOG = 'my_catalog_int',
    NAMESPACE_MODE = FLATTEN_NESTED_NAMESPACE,
    NAMESPACE_FLATTEN_DELIMITER = '-'
  )
  EXTERNAL_VOLUME = 'my_external_vol';

Copy

Erstellen Sie eine mit dem Katalog verknüpfte Datenbank, die automatische Anmeldeinformationen verwendet und einen zulässigen Namespace angibt:

CREATE DATABASE my_linked_db
  LINKED_CATALOG = (
    CATALOG = 'my_catalog_int_vended_creds',
    ALLOWED_NAMESPACES = ('my_namespace')
  );

Copy