Installieren der Snowflake Python APIs-Bibliothek

Sie können die Snowflake Python APIs-Bibliothek zur Verwendung mit conda oder einer virtuellen Umgebung installieren. Stellen Sie vor Beginn sicher, dass die unterstützten Python-Versionen verwendet werden.

Um die Snowflake Python APIs-Bibliothek einzustellen, führen Sie die folgenden Schritte aus:

  1. Aktivieren Sie eine Python-Umgebung.

  2. Installieren Sie die Bibliothek.

  3. Einstellung der Optionen für den Python-API-Client.

Python-Umgebung aktivieren

Um eine Umgebung einzurichten, in der Sie Python-Code ausführen können, müssen Sie eine Python-Umgebung aktivieren. Sie können zum Beispiel conda oder eine virtuelle Umgebung (venv) verwenden.

Bemerkung

Die folgenden Schritte werden nur als Beispiel dargestellt. Wenn Sie dem Beispiel folgen, benötigen Sie möglicherweise zusätzliche Rechte für Daten, Produkte oder Dienste von Drittanbietern, die nicht im Besitz von Snowflake sind oder von Snowflake bereitgestellt werden. Stellen Sie sicher, dass Sie über die entsprechenden Rechte für Daten, Produkte oder Dienstleistungen Dritter verfügen, bevor Sie fortfahren.

Sie können conda verwenden, um eine Umgebung für die Ausführung von Python-Code zu erstellen. Wenn Sie conda nicht haben, können Sie es von der conda-Website installieren.

Weitere Informationen zu conda finden Sie in der Conda-Dokumentation. Weitere Informationen zum Herunterladen und Installieren von conda finden Sie unter Installieren von conda.

  1. Erstellen einer conda-Umgebung:

    conda create -n <env_name> python==3.10
    
    Copy
  2. Aktivieren der Umgebung:

    conda activate <env_name>
    
    Copy

Installieren der Snowflake Python APIs-Bibliothek

Sie können die Snowflake Python APIs-Bibliothek aus dem Python Package Index (PyPI) installieren.

  • Führen Sie in der neu erstellten conda- oder virtuellen Umgebung den folgenden pip-Befehl aus, um die Bibliothek zu installieren:

    pip install snowflake -U
    
    Copy

    Das Snowflake Paket ist das übergeordnete PEP 420 Namespace Paket für das Snowflake Python APIs. Es enthält snowflake.core, das Unterpaket, das Python-APIs für die Verwaltung von Snowflake-Ressourcenobjekten bereitstellt.

    Durch die Installation des snowflake-Pakets wird automatisch snowflake.core zusammen mit den erforderlichen Abhängigkeiten, einschließlich snowflake-connector-python, installiert.

  • Um auch die Snowpark ML-Bibliothek als zusätzliche Paketabhängigkeit zu installieren, können Sie den folgenden pip-Befehl ausführen:

    pip install "snowflake[ml]" -U
    
    Copy

Nachdem Sie die Bibliothek installiert haben, müssen Sie erst eine Verbindung zu Snowflake herstellen, bevor Sie die API verwenden können. Weitere Informationen zum Herstellen der Verbindung finden Sie unter Verbinden mit Snowflake mit dem Snowflake Python APIs.

Python API-Client-Optionen einstellen

Sie können die folgenden Umgebungsvariablen einstellen, um die Client-Optionen für den Snowflake Python APIs zu steuern:

_SNOWFLAKE_PRINT_VERBOSE_STACK_TRACE

Gibt an, ob die vollständige Stapelablaufverfolgung (Stack) in gedruckten Fehlermeldungen aktiviert ist.

Mögliche Werte:

  • Aktiviert: true, t, yes, y, on, oder undefiniert

  • Deaktiviert: Jeder andere Wert

Standard: Aktiviert

Wenn diese Option deaktiviert ist, setzt der API-Client bei der Verarbeitung von Anfragen sys.tracebacklimit auf 0. Diese Einstellung veranlasst den Client, Traceback-Informationen für alle Arten von Ausnahmen zu unterdrücken (nicht nur für die, die sich auf den API-Client beziehen) und nur die Fehlermeldungen zu drucken.

Um diese Option für Python-Notebook-Umgebungen zu deaktivieren, führen Sie die folgende Zeile in Ihrem Notebook aus:

%env _SNOWFLAKE_PRINT_VERBOSE_STACK_TRACE=false
Copy
_SNOWFLAKE_ENABLE_RETRY_REQUEST_QUERY

Gibt an, ob bei Abfragen mit bestimmten Status-Codes automatische Wiederholungsversuche aktiviert sind.

Mögliche Werte:

  • Aktiviert: true, t, yes, y, on

  • Deaktiviert: Jeder andere Wert oder undefiniert

Standard: Aktiviert

Wenn diese Option aktiviert ist, wiederholt der Client-API automatisch Abfragen, wenn sie die folgenden Status-Codes aufweisen:

  • 202

  • 429

  • 503

  • 504