Snowflakeへのログイン¶
Snowflakeの使用を開始する初期段階では、ウェブベースのユーザーインターフェイス、または SnowSQL (インターフェイスからダウンロードできるコマンドラインクライアント)を使用してログインすることをお勧めします。
次に、Snowflakeに慣れたら、他の方法を使用してSnowflakeへの接続を探索できます。
このトピックの内容:
Snowflakeアカウント名¶
Snowflakeへのすべてのアクセスは、アカウント名(Snowflakeが提供)、または次の形式を使用する URL を介して行われます。
https://アカウント名.snowflakecomputing.com
ただし、完全なアカウント名には、アカウントがホストされている 地域 および クラウドプラットフォーム を識別する 追加の セグメントが含まれることがあります。
地域別のアカウント名の例
アカウント名が xy12345
の場合、
クラウドプラットフォーム/地域 |
完全なアカウント名 |
---|---|
AWS |
|
US 西部(オレゴン)
|
|
US 東部(オハイオ)
|
|
US 東部(バージニア北部)
|
|
US 東部(商業組織、バージニア政府北部)
|
|
カナダ(中部)
|
|
ヨーロッパ(ロンドン)
|
|
EU (アイルランド)
|
|
EU (フランクフルト)
|
|
アジア太平洋(東京)
|
|
アジア太平洋(ムンバイ)
|
|
アジア太平洋(シンガポール)
|
|
アジア太平洋(シドニー)
|
|
GCP |
|
US 中央部1(アイオワ)
|
|
ヨーロッパ西部2(ロンドン)
|
|
ヨーロッパ西部4(オランダ)
|
|
Azure |
|
西 US 2(ワシントン)
|
|
東 US 2(バージニア)
|
|
US 政府バージニア
|
|
カナダ中央部(トロント)
|
|
西ヨーロッパ(オランダ)
|
|
スイス北部(チューリッヒ)
|
|
東南アジア(シンガポール)
|
|
オーストラリア東部(ニューサウスウェールズ)
|
|
重要
次のいずれかの条件に該当する場合、完全なアカウント名は、上記の例の構造とは異なります。
Snowflake Editionが VPS の場合、アカウント名の詳細については Snowflakeサポート にお問い合わせください。
アカウントで AWS PrivateLink またはAzure Private Linkが有効になっている場合、アカウント名には、地域セグメントの代わりに
privatelink
セグメントが 必要 です。詳細については、以下をご参照ください。
ウェブインターフェイスを使用したログイン¶
Snowflakeのウェブインターフェイスにログインするには、
ご使用のアカウント用にSnowflakeが提供するホスト名をブラウザーで指定します(詳細については前のセクションを参照)。URL は
https://
で始まる必要があります。ウェブブラウザーがSnowflakeサービスと通信できる場合、次のログイン画面が表示されます。
認証情報(ユーザーログイン名とパスワード)を入力し、 Log In をクリックします。
ウェブインターフェイスで実行できるタスクの詳細については、 ウェブインターフェイスのクイックツアー をご参照ください。
SnowSQLを使用したログイン¶
SnowSQL は、Snowflakeに接続して SQL クエリを実行し、データベーステーブルに対するデータのロードとアンロードを含むすべての DDL および DML 操作を実行するためのコマンドラインクライアントです。
ステップ1: SnowSQL をダウンロードし、インストールする¶
SnowSQL インストーラーは、 Snowflakeクライアントリポジトリ からダウンロードできます。認証は不要です。このバージョンの SnowSQL インストーラーは、パッチの自動アップグレードを有効にします。
詳細な手順については、 SnowSQL のインストール をご参照ください。
SnowSQL をインストールするには、
ターミナルウィンドウを開きます。
curl
を実行して SnowSQL インストーラーをダウンロードします。柔軟性を高めるため、Snowflakeは SnowSQL インストーラーのダウンロード用にAmazon Web Services(AWS)とAzureエンドポイントの両方を提供しています。サポートされている任意のクラウドプラットフォームでホストされているアカウントでは、 いずれの エンドポイントからもインストーラーをダウンロードできます。
Linux
- AWS エンドポイント
$ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/1.2/linux_x86_64/snowsql-1.2.10-linux_x86_64.bash
- Microsoft Azureエンドポイント
$ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/1.2/linux_x86_64/snowsql-1.2.10-linux_x86_64.bash
macOS
- AWS エンドポイント
$ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/<bootstrap_version>/darwin_x86_64/snowsql-<version>-darwin_x86_64.pkg
- Microsoft Azureエンドポイント
$ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/<bootstrap_version>/darwin_x86_64/snowsql-<version>-darwin_x86_64.pkg
Windows
- AWS エンドポイント
$ curl -O https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/1.2/windows_x86_64/snowsql-1.2.10-windows_x86_64.msi
- Microsoft Azureエンドポイント
$ curl -O https://sfc-repo.azure.snowflakecomputing.com/snowsql/bootstrap/1.2/windows_x86_64/snowsql-1.2.10-windows_x86_64.msi
インストーラーを実行します。
Linux
ターミナルウィンドウを開きます。
ダウンロード場所からBashスクリプトインストーラーを実行します。
$ bash snowsql-linux_x86_64.bash
インストーラーの指示に従います。
macOS
ダウンロード場所の
snowsql-darwin_x86_64.pkg
をダブルクリックして、インストーラー PKG ファイルを実行します。インストーラーの指示に従います。
Windows
ダウンロード場所の
snowsql-windows_x86_64.msi
をダブルクリックして、インストーラー MSI ファイルを実行します。インストーラーの指示に従います。
Zシェルエイリアスの設定(macOSのみ)¶
Zシェル(zshとも呼ばれます)がデフォルトのターミナルシェルである場合は、ターミナルのコマンドラインで SnowSQL を実行できるように、エイリアスを SnowSQL 実行可能ファイルに設定します。SnowSQL インストーラーは実行可能ファイルを /Applications/SnowSQL.app/Contents/MacOS/snowsql
にインストールし、このパスを PATH または ~/.profile
のエイリアスエントリに追加します。zshは通常このファイルを読み取らないため、 ~/.zshrc
のこのパスにエイリアスを追加します。これはzsh が読み取ります。
SnowSQL 実行可能ファイルにエイリアスを追加するには:
~/.zshrc
ファイルを開きます(ない場合は作成します)。次の行を追加します。
alias snowsql=/Applications/SnowSQL.app/Contents/MacOS/snowsql
ファイルを保存します。
ステップ2: Snowflakeに接続してセッションを開始する¶
端末ウィンドウから、次のコマンドを使用してコマンドプロンプトから SnowSQL を起動します。
$ snowsql -a <account_name>
<アカウント名>
はSnowflakeによって割り当てられた名前です。アカウント名を指定するときには、Snowflakeドメイン名を 含めない ように注意します(つまり、snowflakecomputing.com
)。アカウント名のみを含めます(必要に応じて、地域とクラウドプラットフォームの情報を含む)。詳細については、 Snowflakeアカウント名 (このトピック内)をご参照ください。-u
オプションに続いてユーザーログイン名を指定すると、ログインをさらに効率化できます。$ snowsql -a <account_name> -u <user_login_name>
プロンプトが表示されたら、ログイン名( SnowSQL の実行時に指定しなかった場合)とパスワードを入力します。
有効なアカウント名、ユーザーログイン名、およびパスワードを指定した場合、 SnowSQL プロンプトが表示されます。
ちなみに
セキュリティ上の理由により、コマンドラインのオプションとしてパスワードを指定することはできません。 SnowSQL がパスワードの入力を求めるのを待つ必要があります。
ただし、コマンドラインでの情報入力をスキップする場合や、ログインを自動化する必要がある場合は、必要なすべてのアカウントおよびユーザーの認証情報、および追加のSnowflakeのデフォルト使用情報を SnowSQL config
ファイルにオプションとして提供できます。
インストール、構成、ログイン、および使用法の詳細については、 SnowSQL (CLI クライアント) をご参照ください。
他の方法を使用した接続¶
Snowflakeのウェブインターフェイスと SnowSQL に加えて、Snowflakeは次のような接続のための多くの方法をサポートしています。
JDBC または ODBC をサポートするサードパーティクライアントサービスおよびアプリケーションの使用。
Python、Node.js、SparkなどのSnowflakeコネクタ/ドライバーを介して接続するアプリケーションの開発。
ただし、これらの他の方法を使用してSnowflakeに接続するには、追加のインストール、構成、および開発タスクが必要です。詳細については、 Snowflakeへの接続 をご参照ください。