Snowflake

適用先: Tableau Cloud, Tableau Desktop, Tableau Prep, Tableau Server

この記事では、Tableau を Snowflake データウェアハウスに接続し、データソースを設定する方法について説明します。

はじめる前に

開始する前に、次の接続情報を収集します。

接続するサーバーの名前
認証方法:
- OAuth: IDP からフェデレーションを有効にする場合は、この方法を使用します。
- SAML IDP: 接続に IDP 認証資格情報を埋め込む場合は、この方法を使用します。
- ユーザー名とパスワード: ユーザーの認証資格情報を Snowflake に保存する場合は、この方法を使用します。

サインインするための認証資格情報は、選択する認証方式によって異なります
(オプション) Tableau が接続するたびに初期 SQL ステートメントを実行する

必要なドライバー

このコネクタにはデータベースとやり取りするためのドライバーが必要です。お使いのコンピューターにはすでに必要なドライバーがインストールされています。ドライバーがコンピューターにインストールされていない場合、Tableau によって「ドライバーダウンロード」(新しいウィンドウでリンクが開く)ページへのリンクを含むメッセージが接続ダイアログボックスに表示されます。このページで、ドライバーのリンクとインストール手順を確認できます。

注: Snowflake で OAuth を使用するには、最新の ODBC ドライバーを Snowflake からインストールする必要があります。現在のバージョンは 2.25.4 です。

接続してデータソースを設定する

接続先として Snowflake を選択すると、3 つのタブからなるポップアップメニューが表示されます。[一般] タブは、認証に使用します。[初期 SQL] を使用すると、すべての接続の初めに SQL コマンドを実行することもできます。詳細については、「初期 SQL の実行」を参照してください。[詳細] タブを使用すると、パラメーターを使用して顧客接続を追加できます。

Tableau のデータへの接続

Tableau を起動し、[接続] の下で [Snowflake] を選択します。
接続するサーバーの名前を入力します。
認証メソッドを、[ユーザー名とパスワード]、[Okta のユーザー名とパスワード]、または [OAuth を使用したサインイン] から選択します。
1 つの認証メソッドを選択し、ログイン手順を実施します。
Okta のユーザー名とパスワード:
1. [ユーザー名] と [パスワード] を入力します。
2. [Okta] フィールドに、Okta サーバーの URL を入力します。
OAuth を使用したサインイン
1. (オプション) すべての接続の初めに SQL コマンドを実行する場合、[初期 SQL] を選択します。詳細については、初期 SQL の実行を参照してください。
2. [サインイン] を選択します。
3. 開いた Web ページで、[ユーザー名] と [パスワード] を入力して [ログイン] を選択し、Snowflake にログインします。または、Snowflake が SSO をサポートするように構成されている場合は [シングルサインオン] を選択します。
4. [OK] をクリックし、Snowflake データにアクセスするための許可を確認します。
5. ブラウザー画面と Tableau を閉じます。
6. 次のセクション「データソースの設定」に進みます。
[サインイン] を選択します。

Tableau が接続できない場合は、認証資格情報が正しいことを確認します。引き続き接続に失敗する場合は、コンピューターにおけるサーバーの検出に問題があります。ネットワーク管理者またはデータベース管理者に連絡してください。

アクセストークンのタイムアウト: アクセストークン TDC を常に検証する

Snowflake のアクセストークンは 10 分で有効期限が切れます。抽出更新のプロセスによっては、アクセストークンの有効期限が切れ、ジョブの途中で新しい接続が確立されます。この問題に対処するために、Tableau 2024.2 以降ではデフォルトで有効になる新しい機能を追加しました。古いリリースでこの機能を有効にするには、次の TDC を使用します。

<connection-customization class='snowflake' enabled='true' version='10.0'>
    <vendor name='snowflake' />
    <driver name='snowflake' />
    <customizations>
        <customization name='CAP_OAUTH_VALIDATE_ALWAYS' value='yes'/>
    </customizations>
</connection-customization>

Tableau Cloud を使用している場合は、Tableau リポジトリのデータソースフォルダーに TDC をインストールして Tableau Desktop からパブリッシュできます。これにより、パブリッシュ時にワークブックまたはデータソースに TDC が埋め込まれます。

サーバー側に別の TDC がインストールされていない限り、有効化フラグのステータスに関係なく、埋め込まれた TDC は常に適用されます。また、Tableau Cloud にはインストールされた TDC はありません (埋め込まれたものだけです)。

注: 埋め込み TDC はフローではサポートされません。

ドライバーパラメーターを使用した接続のカスタマイズ

Snowflake コネクタで行われた接続を変更するには、[詳細] タブの接続文字列にドライバーパラメーターを追加します。

注: Tableau が生成するドライバーパラメーターは変更できません。パラメーターの追加のみを行えます。

たとえば、次の構文では、no_proxy の値が満たされず、ホスト名がプロキシサーバーをバイパスできるものである場合に使用するプロキシサーバーを指定しています。

Proxy=http://proxyserver.company:80;no_proxy=.trustedserver.com;

その他のカスタムドライバーパラメーターの例については、「Snowflake にプロキシを使用するを参照してください。

注: データソースに埋め込まずにカスタマイズする場合は、Windows のレジストリでパラメーターを構成できます (「構成パラメーター」としてマークされているパラメーターのみが使用可能です)。ドライバーパラメーターについての詳細は、Snowflake のウェブサイトの「ODBC 構成と接続パラメーター」を参照してください。

データソースの設定

データソースページで次の手順を行います。

(任意) ページ上部にある既定のデータソース名を選択し、Tableau で使用する一意のデータソース名を入力します。たとえば、データの他のユーザーが、どのデータソースに接続するか推測するのに役立つ命名規則を使用します。
[ウェアハウス] ドロップダウンからウェアハウスを選択するか、テキストボックスを使用してウェアハウスを名前で検索します。
注: 空白のままにしてウェアハウスを選択しない場合、Tableau はデフォルトの Snowflake 仮想ウェアハウスを使用します。
詳細については、「Snowflake のデフォルト仮想ウェアハウス」を参照してください。
[データベース] ドロップダウンからデータベースを選択するか、テキストボックスを使用してデータベースを名前で検索します。
[スキーマ] ドロップダウンからスキーマを選択するか、テキストボックスを使用してスキーマを名前で検索します。
[表] で、表を選択するかテキストボックスを使用して、名前で表を検索します。
表をキャンバスにドラッグしてから、シートタブを選択して分析を開始します。カスタム SQL を使用して、データソース全体ではなく、特定のクエリに接続します。詳細については、カスタム SQL クエリへの接続を参照してください。

Mac でのサインイン

Mac で Tableau Desktop を使用する場合、サーバー名を入力して接続するときに、mydb または mydb.test などの相対ドメイン名の代わりに mydb.test.ourdomain.lan などの完全修飾ドメイン名を使用します。

また、Mac コンピューターの [検索ドメイン] リストにドメインを追加し、接続する際には、サーバー名のみを提供する必要があります。[検索ドメイン] リストを更新するには、[システム環境設定] > [ネットワーク] > [詳細] に移動し、[DNS] タブを開きます。

Snowflake のデフォルト仮想ウェアハウス

Snowflake データソースを作成するとき、Snowflake ウェアハウス (計算リソース用) と Snowflake データベース (データリソース用) の両方を作成しています。ウェアハウスとデータベースの両方に、アクセスするためのパーミッションが必要です。各ウェアハウスとデータベースに対する権限がある場合は、必要な計算能力に応じて、異なるウェアハウスを使用して同じデータベースにアクセスできます。

データソースを作成するときに、ドロップダウンリストからウェアハウスを選択するオプションがあります。このオプションを空白のままにしてウェアハウスを選択しない場合、Tableau は既定の Snowflake 仮想ウェアハウスを使用します。その後、そのデータソースまたはワークブックをパブリッシュすると、ユーザーが接続したとき、Tableau はそのユーザーのデフォルトの Snowflake 仮想ウェアハウスを使用します。

Tableau がデフォルトのウェアハウスを使用して Snowflake データソースからワークブックを開くことができるように、各ユーザーにデフォルトのウェアハウスを割り当てる必要があります。

Snowflake サーバーサポートでの OAuth の構成

Tableau と Snowflake の間の接続に OAuth を構成する方法については、「Snowflake 接続の OAuth の構成(新しいウィンドウでリンクが開く)」を参照してください。

Snowflake にプロキシを使用する

プロキシを介して Tableau から Snowflake に接続できます。バージョン 2019.4 以降の Tableau を使用している場合、コネクタダイアログで [詳細] タブに必要なパラメーターを入力することで設定できます。

例:

proxy=http://proxyserver.company:80

使用する必要があるパラメーターの詳細については、Snowflake のドキュメント(新しいウィンドウでリンクが開く)を参照してください。

注: Tableau では Snowflake への接続に DSN が使用されないため、Snowflake のドキュメントで DSN の使用方法を説明する部分は無視できます。

バージョン 2019.4 より前の Tableau を使用している場合、TDC ファイルで odbc-extras を使用してパラメーターを入力することによって設定できます。

例:

コピー

<connection-customization class='snowflake' enabled='true' version='19.1'>
        <vendor name='snowflake' />
            <driver name='snowflake' />
                <customizations>
                <customization name='odbc-connect-string-extras' value='proxy=http://proxyserver.company:80' />
                </customizations></connection-customization>

詳細については、「Customize the Connection String for a Native Connector」(新しいウィンドウでリンクが開く)の記事を参照してください。

トラブルシューティング

パフォーマンス

Tableau を Snowflake で使用中に発生するパフォーマンスの問題を解決するには、次の情報を参考にしてください。

フェッチサイズ

制限のない VARCHAR フィールドまたは VARBINARY フィールドを使用すると、ドライバーはフィールドサイズとして 16M を返します。これにより、Tableau はメモリ制限内に収めるために小さなフェッチサイズを使用するため、クエリ速度が低下します。これにはいくつかの対処方法があります。

スキーマの変更

VARCHAR(256) などのサイズを列定義に追加すると、Tableau は最適なフェッチサイズを計算できるようになります。

TDC カスタマイズ

ドライバーパラメーターとして default_varchar_size または default_binary_size を使用することもできます。

また、[こちら](https://docs.snowflake.com/ja/developer-guide/odbc/odbc-parameters) を使用して、無制限フィールドの最大フィールドサイズを設定することもできます。

高度な UI または TDC を使用できます。

追加の機能 CAP_ODBC_FETCH_BUFFERS_RESIZABLE も設定する必要があります。

注: Tableau Bridge を使用していない限り、このソリューションは Tableau Cloud では機能しません。

Tableau ブリッジを使用している場合は、ブリッジホストに TDC をインストールして、そのホストを通過するすべての接続に適用することができます。以下の例を参照してください。

前述の UI を使用して各データソースのフィールドサイズをカスタマイズする予定の場合は、この TDC を使用します。

コピー

<connection-customization class='snowflake' enabled='true' version='10.0'>
    <vendor name='snowflake' />
    <driver name='snowflake' />
    <customizations>
        <customization name='CAP_ODBC_FETCH_BUFFERS_RESIZABLE' value='yes'/>
    </customizations>
</connection-customization>

この TDC を使用して、すべてのデータソースのカスタマイズを適用します。

コピー

<connection-customization class='snowflake' enabled='true' version='10.0'>
<vendor name='snowflake' />
<driver name='snowflake' />
<customizations>
<customization name='CAP_ODBC_FETCH_BUFFERS_RESIZABLE' value='yes'/>
<customization name='odbc-connect-string-extras' value='default_varchar_size=512;default_binary_size=512'/>
</customizations>
</connection-customization>

よくある質問

よくある問題と解決までのステップを紹介します。

「このフィールド XXX は存在しません」というエラーが表示されています。どうすればよいですか?

このエラーは、計算フィールドを作成してワークシートに追加し、データソースを Snowflake データ (CustomSQL) に置き換えると表示されます。

[Replace Field References (フィールドの参照を置換する)] 機能を使用して、エラーを解決します。詳細については、「フィールドの参照の置換」を参照してください。

Snowflake Web サイトの「Snowflake で Tableau を使用するためのベストプラクティス (英語)」(新しいウィンドウでリンクが開く) (登録が必要)。

このセクションの他の記事

一番上に戻る

フィードバックをお送りいただき、ありがとうございます。

フィードバックは正常に送信されました。ありがとうございます!

Tableau Desktop と Web 作成のヘルプ

Snowflake

はじめる前に

必要なドライバー

接続してデータソースを設定する

Tableau のデータへの接続

Okta のユーザー名とパスワード:

OAuth を使用したサインイン

アクセストークンのタイムアウト: アクセストークン TDC を常に検証する

ドライバーパラメーターを使用した接続のカスタマイズ

データソースの設定

Mac でのサインイン

Snowflake のデフォルト仮想ウェアハウス

Snowflake サーバーサポートでの OAuth の構成

Snowflake にプロキシを使用する

トラブルシューティング

パフォーマンス

フェッチサイズ

スキーマの変更

TDC カスタマイズ

よくある質問

関連項目

このセクションの他の記事

Tableau Desktop と Web 作成のヘルプ

Snowflake

はじめる前に

必要なドライバー

接続してデータ ソースを設定する

Tableau のデータへの接続

Okta のユーザー名とパスワード:

OAuth を使用したサインイン

アクセス トークンのタイムアウト: アクセス トークン TDC を常に検証する

ドライバー パラメーターを使用した接続のカスタマイズ

データ ソースの設定

Mac でのサインイン

Snowflake のデフォルト仮想ウェアハウス

Snowflake サーバー サポートでの OAuth の構成

Snowflake にプロキシを使用する

トラブルシューティング

パフォーマンス

フェッチ サイズ

スキーマの変更

TDC カスタマイズ

よくある質問

関連項目

このセクションの他の記事

接続してデータソースを設定する

アクセストークンのタイムアウト: アクセストークン TDC を常に検証する

ドライバーパラメーターを使用した接続のカスタマイズ

データソースの設定

Snowflake サーバーサポートでの OAuth の構成

フェッチサイズ