Konfigurieren Sie eine Katalogintegration für Apache Iceberg™ REST-Kataloge

Eine Apache Iceberg™ REST Katalogintegration ermöglicht Snowflake den Zugriff auf Apache Iceberg™-Tabellen, die in einem Remote-Katalog verwaltet wird, der mit der Open Source Apache Iceberg REST OpenAPI-Spezifikation übereinstimmt.

Snowflake unterstützt die folgenden zusätzlichen Features, wenn Sie eine Iceberg REST-Katalogintegration verwenden:

Methoden der Authentifizierung

Snowflake unterstützt die folgenden Authentifizierungsmethoden für Iceberg REST-Kataloge:

  • OAuth

  • Bearer-Token oder persönliches Zugriffstoken (PAT)

  • Signatur Version 4 (SigV4)

Die unterstützten Authentifizierungsmethoden variieren je nach Katalogquelle.

Rotation von Anmeldeinformationen

Um die Anmeldeinformationen für eine Katalogintegration zu rotieren, können Sie den Befehl ALTER CATALOG INTEGRATION verwenden, um die Anmeldeinformationen zu aktualisieren, die Snowflake für die Authentifizierung bei Ihrem Remote-Katalog verwendet.

Beispiel:

ALTER CATALOG INTEGRATION my_cat_int SET
  REST_AUTHENTICATION (
    OAUTH_CLIENT_SECRET = 'myNewSecret'
  );

Konnektivitätsoptionen

In diesem Abschnitt werden die Verbindungsoptionen für Iceberg-REST-Kataloge beschrieben.

Automatische Anmeldeinformationen

Zusätzlich zu Externen Volumes unterstützt Snowflake die folgenden Verbindungsoptionen für Iceberg REST-Kataloge:

Die unterstützten Verbindungsoptionen variieren je nach Katalogquelle.

Private Konnektivität

Snowflake unterstützt die Verbindung zu Iceberg-REST-Katalogen über private Konnektivität.

Wenn Sie jedoch über eine private Konnektivität eine Verbindung zum Katalog herstellen, müssen Sie ein externes Volume verwenden, um eine Verbindung zu den Katalogdaten herzustellen.

Die unterstützten Verbindungsoptionen variieren je nach Katalogquelle.

Katalogquellen

Snowflake unterstützt jeden externen Katalogserver, der mit der Iceberg REST-Spezifikation übereinstimmt.

Die folgenden Themen enthalten Beispiele für häufig verwendete REST-Kataloge:

Durchsuchen eines Remote-Katalogs

Nachdem Sie eine Katalogintegration für Iceberg REST erstellt haben, können Sie die folgenden Snowflake-Systemfunktionen verwenden, um Namespaces und Tabellen im Katalog zu durchsuchen:

Tabelle zu einer Iceberg-REST-Katalogintegration migrieren

Nachdem Sie eine Katalogintegration für Iceberg-REST erstellt haben, können Sie bei Bedarf die Katalogintegration, die mit einer extern verwalteten Iceberg-Tabelle in einer Standard-Snowflake-Datenbank verbunden ist, durch die von Ihnen erstellte Katalogintegration ersetzen. Eine Anweisung dazu finden Sie unter SYSTEM$SET_CATALOG_INTEGRATION.

Eine mit dem Katalog verbundene Datenbank erstellen

Nachdem Sie eine Katalogintegration für Iceberg REST erstellt haben, können Sie eine mit dem Katalog verknüpfte Datenbank erstellen, um die Daten von Ihrem externen Iceberg REST-Katalog in Snowflake zu übertragen. Wenn Sie die mit dem Katalog verknüpfte Datenbank erstellen, geben Sie den Namen der von Ihnen erstellten Katalogintegration als Katalog an.

Eine mit dem Katalog verknüpfte Datenbank erkennt automatisch die Namespaces und Tabellen in Ihrem Remote-Katalog und bleibt mit ihnen synchron. Sie können eine mit dem Katalog verknüpfte Datenbank verwenden, um von Snowflake aus in die Tabellen in Ihrem Remote-Katalog zu lesen und zu schreiben, während gleichzeitig die vollständige Interoperabilität mit Ihrem bestehenden Iceberg-Ökosystem erhalten bleibt. Weitere Informationen dazu finden Sie unter folgenden Themen: