Snowflake Python API によるSnowflakeへの接続¶

Pythonディクショナリを使用した接続¶

Pythonディクショナリを使用することで、Snowflakeへの接続に必要な値を指定することができます。接続時は、このディクショナリを接続に使用する関数やメソッドの引数として渡します。

import os

CONNECTION_PARAMETERS = {
    "account": os.environ["snowflake_account_demo"],
    "user": os.environ["snowflake_user_demo"],
    "password": os.environ["snowflake_password_demo"],
    "database": "test_database",
    "warehouse": "test_warehouse",
    "schema": "test_schema",
}

構成ファイルを使用した接続¶

接続定義を TOML 構成ファイル で指定できます。これにより、コード内でSnowflakeへの接続を明示的に定義する必要がなくなります。

たとえば、 ~/.snowflake/connections.toml に構成ファイルを作成し、以下のような接続パラメーターを追加するとします。

[myconnection]
account = "test_account"
user = "test_user"
password = "******"
warehouse = "test_warehouse"
database = "test_database"
schema = "test_schema"

この例では、アカウント test_account、ユーザ test_user、パスワードの認証情報とデータベース情報を持つ myconnection というSnowflake接続を定義します。

接続定義は、 Snowflake Pythonコネクタ で利用可能なものと同じ構成オプションをサポートします。

Snowpark Session による接続¶

Python用Snowpark API を使用している場合、その snowflake.snowpark.Session オブジェクトを使用してSnowflakeへの接続を作成できます。

Session の作成の詳細については、 Snowpark Pythonのセッションの作成 をご参照ください。

次の例のコードは、構成ファイルで定義された接続パラメーターを使用して、Snowflakeへの接続を作成します。出来上がった Session オブジェクトを使って、コードは Root オブジェクトを作成し、そこから API を使用します。

from snowflake.core import Root
from snowflake.snowpark import Session

session = Session.builder.config("connection_name", "myconnection").create()
root = Root(session)

Pythonコネクタ Connection による接続¶

Python用Snowflakeコネクタ を使用している場合、その snowflake.connector.connect 関数を使用してSnowflakeへの接続を作成できます。関数は Connection を返します。

Python用Snowflakeコネクタ API の詳細については、 Pythonコネクタ API をご参照ください。

次の例のコードは、構成ファイルで定義された接続パラメーターを使用して、Snowflakeへの接続を作成します。出来上がった Connection オブジェクトを使って、コードは Root オブジェクトを作成し、そこから API を使用します。

from snowflake.connector import connect
from snowflake.core import Root

connection = connect(connection_name="myconnection")
root = Root(connection)