Snowflake Python APIs ライブラリのインストール

condaまたは仮想環境で使用するために Snowflake Python APIs ライブラリをインストールすることができます。開始する前に、 サポートされるPythonのバージョン を確認してください。

Snowflake Python Snowflake Python APIs ライブラリをセットアップするには、以下のステップを完了します。

  1. Python環境を アクティブ化 します。

  2. ライブラリを インストール します。

  3. Python APIクライアントの オプションを設定する。

Python環境をアクティブ化する

Pythonコードを実行する環境をセットアップするには、Python環境をアクティブ化する必要があります。たとえば、 Conda を使用することも、 仮想環境 を使用することもできます。

Condaを使用する

注釈

これらのステップはあくまで例として示したものです。例に従う場合には、Snowflakeが所有または提供していないサードパーティのデータ、製品、またはサービスに対する追加の権利が必要になる場合があります。続行する前に、サードパーティのデータ、製品、またはサービスに対する適切な権利を持っていることを確認してください。

condaを使用して、Pythonコードを実行する環境を作成できます。condaがない場合は、condaのウェブサイトからインストールできます。

condaの詳細については、 Condaのドキュメント をご参照ください。condaをダウンロードおよびインストールするには、 condaのインストール をご参照ください。

  1. Conda環境を作成します。

    conda create -n <env_name> python==3.10
    Copy

  2. 環境をアクティブ化します。

    conda activate <env_name>
    Copy

仮想環境を使用する

venvを使用して、Pythonコードを実行する仮想環境を作成できます。Pythonがまだない場合は、Pythonをダウンロードおよびインストールしてから、仮想環境を作成します。

venvの詳細については、 venv - 仮想環境の作成 をご参照ください。Pythonをダウンロードするには、 Pythonのダウンロード をご参照ください。

  1. 仮想環境を作成するには、 venv を使用します。

    cd <your Python project root folder>
python3 -m venv '.venv'
    Copy

  2. 環境をアクティブ化します。

    source '.venv/bin/activate'
    Copy

Snowflake Python APIs ライブラリのインストール

Snowflake Python APIs ライブラリはPython Package Index（PyPI）からインストールできます。

  • 作成したCondaまたは仮想環境で、次の pip コマンドを実行してライブラリをインストールします。

    pip install snowflake -U
    Copy

snowflake パッケージをインストールすると、Snowflake Pythonコネクタ、Snowpark Pythonライブラリ、および snowflake.core などのすべてのサブパッケージが依存関係として自動的にインストールされます。

  • Snowpark ML ライブラリを追加パッケージ依存関係としてインストールするには、次の pip コマンドを実行します。

    pip install "snowflake[ml]" -U
    Copy

ライブラリをインストールしたら、 API を使用する前にSnowflakeへの接続を作成する必要があります。接続に関する詳細については、 Snowflake Python APIs によるSnowflakeへの接続 をご参照ください。

Python API クライアント オプションの設定

以下の環境変数を設定して、 Snowflake Python APIs のクライアント・オプションを制御できます。

_SNOWFLAKE_PRINT_VERBOSE_STACK_TRACE

印刷されるエラーメッセージでフルスタック・トレースを有効にするかどうかを指定します。

可能な値：

  • 有効: true、 t、 yes、 y、 on

  • 無効: その他の値または未定義

デフォルト: 無効

このオプションを無効にすると、 API クライアントは、エラーメッセージのスタックトレースをフルスタックトレースではなく、縮小したスタックトレースを表示します。

Pythonノートブック環境でこのオプションを無効にするには、ノートブックで以下の行も実行する必要があります。この行を一度実行すると、環境変数はそれ自体でスタック・トレースの動作を制御します。

%xmode minimal
Copy
_SNOWFLAKE_ENABLE_RETRY_REQUEST_QUERY

特定のステータスコードを持つクエリ リクエストに対して自動再試行を有効にするかどうかを指定します。

可能な値：

  • 有効: true、 t、 yes、 y、 on

  • 無効: その他の値または未定義

デフォルト: 有効

このオプションを有効にすると、 API クライアントは、クエリ・リクエストが以下のステータス・コードを持つ場合、自動的にクエリを再試行します。

  • 202

  • 429

  • 503

  • 504

言語: 日本語