Gemeinsame Einrichtung für Snowflake REST APIs-Tutorials

Einführung

Dieses Thema enthält Anweisungen für die gemeinsame Einrichtung, die für alle Snowflake REST APIs-Tutorials in dieser Dokumentation erforderlich ist.

Überblick über die Snowflake REST APIs

Bevor Sie mit der Einrichtung beginnen, werfen Sie einen Blick auf die Snowflake REST APIs.

Die Snowflake REST APIs unterstützt die folgenden Ressourcen über die entsprechenden APIs. Die APIs unterstützen CREATE OR ALTER-Operationen für entsprechende Ressourcen.

Referenzinformationen zu den APIs und ihren Endpunkten finden Sie unter Snowflake REST APIs-Referenz.

Tipp

Wenn Sie lieber Python-Anwendungen schreiben, können Sie die Snowflake Python APIs verwenden, um Snowflake-Objekte zu verwalten. Weitere Informationen dazu finden Sie unter Snowflake Python APIs: Verwalten von Snowflake-Objekten mit Python.

Importieren Sie die Snowflake REST APIs-Sammlungen

Dieses Tutorial führt Sie durch den Import der Snowflake REST APIs-Sammlungen aus Postman.

  1. Laden Sie die Sammlungen API aus dem Git-Repository https://github.com/snowflakedb/snowflake-rest-api-specs/tree/main/public-preview/8.30/collection in einen Ordner herunter.

    ../../../_images/api-collections-git.png

  2. Öffnen Sie die Postman-Anwendung und erstellen Sie, falls erforderlich, ein Konto.

  3. Öffnen Sie in Postman den gewünschten Arbeitsbereich.

    ../../../_images/postman-workspace.png

  4. Wählen Sie Import aus.

    ../../../_images/postman-import-workspace.png

  5. Wählen Sie folders aus.

    ../../../_images/postman-download-collections.png

  6. Wählen Sie im Dialogfeld den Ordner, in den Sie die Sammlung extrahiert haben, und wählen Sie Open.

    ../../../_images/postman-import-elements.png

  7. Vergewissern Sie sich, dass alle Elemente ausgewählt sind, und wählen Sie Import.

    Sie sollten die Auflistung der Sammlungen im linken Bereich sehen, wie in der Abbildung dargestellt:

    ../../../_images/postman-verify-import.png

Geben Sie das Bearer-Token in Postman an

REST-Anfragen benötigen ein JWT-Token im Anfrage-Header, um die Anfrage zu authentifizieren. Wenn Sie kein JWT Token haben, sehen Sie unter Ein JWT-Token generieren nach.

In Postman können Sie das JWT-Token in die bearerToken-Header-Eigenschaft kopieren, wie gezeigt.

../../../_images/postman-bearer-token.png

Sie können dann den x-snowflake-authorization-token-type-Schlüssel in jedem Anfrage-Header auf KEYPAIR_JWT einstellen, wie gezeigt:

../../../_images/postman-set-header.png

Bemerkung

Wie im Tutorial Voraussetzungen erwähnt, müssen Sie eine AUTHENTICATION POLICY definieren. Wenn Sie eine Fehlermeldung ähnlich wie { "code": "390202", "message": "Authentication attempt rejected by the current authentication policy." } erhalten, können Sie den folgenden SQL-Befehl ausführen, um eine Richtlinie zu definieren:

SHOW AUTHENTICATION POLICIES; alter AUTHENTICATION POLICY <your authentication policy> set AUTHENTICATION_METHODS = ('KEYPAIR', 'PASSWORD', 'OAUTH');
Copy

Legen Sie Umgebungsvariablen in der Postman-Umgebung fest

Sie können Umgebungsvariablen in Ihrer Postman-Umgebung festlegen. Sie können diese Variablen dann in Postman in der Form {{variable_name}} verwenden.

Alle Endpunkt-URLs beginnen mit einem baseURL, das Ihr Snowflake-Konto identifiziert. Die baseURL hat die Form: <account_locator>.snowflakecomputing.com, wobei <account_locator> der Name Ihres Snowflake-Kontos ist.

Um die Variable baseURL sowie alle anderen Variablen in Postman festzulegen, aktivieren Sie jeden Parameter und legen seinen Wert fest, wie gezeigt:

../../../_images/postman-env-vars.png

Für jeden Wert, den Sie festlegen, müssen Sie Save wählen, um den neuen Wert zu speichern.

Nächste Schritte

Herzlichen Glückwunsch! In diesem Tutorial haben Sie die Grundlagen für die Verwaltung von Snowflake-Datenbank-, Schema- und Tabellenressourcen unter Verwendung von Snowflake REST APIs gelernt.

Zusammenfassung

Dabei haben Sie die folgenden Schritte durchgeführt:

  • Importieren Sie Snowflake REST APIs-Sammlungen.

  • Geben Sie in Postman ein Bearer-Token an.

  • Legen Sie Umgebungsvariablen in der Postman-Umgebung fest.

Nächstes Tutorial

Sie können nun mit Tutorial 1: Datenbanken, Schemas und Tabellen erstellen und verwalten fortfahren, wo Sie erfahren, wie Sie Snowflake-Datenbanken, Schemas und Tabellen erstellen und verwalten.

Sprache: Deutsch