メインコンテンツへスキップ

はじめに

Snowflake OAuth Writebackコネクターを使用すると、すべてのデータをDomoに格納して正規化した後にSnowflakeに送り返し、同時にクエリでもそれを利用可能にすることが簡単になります。データウェアハウジングソリューションとして既にSnowflakeを使用している場合、このコネクターは、SnowflakeとDomoを併用してデータを最大限に活用するために役立ちます。このコネクターを使用するには、Snowflakeアカウント名(ドメイン)と、 クライアントの登録時にSnowflakeから提供された クライアントIDおよびクライアントシークレットが必要です。Snowflake APIの詳細については、 https://docs.snowflake.net/manuals を参照してください。 Data CenterでSnowflakeアカウントに接続します。このトピックでは、Snowflake OAuth Writebackコネクターのユーザーインターフェースに固有のフィールドとメニューについて説明します。DataSetの追加や更新スケジュールの設定、DataSet情報の編集に関する一般的な情報は、「 コネクターを使用してDataSetを追加する 」を参照してください。
注記: Writeback DataSetの所有者は、入力DataSetの所有者または共同所有者である必要があります。

ベストプラクティス

重要: Snowflakeでは、アカウントが期限切れになるたびに手動でDomoアカウントを再接続する必要があります。アカウントの有効期限は、Snowflake統合によってコントロールされています。90日ごとに更新トークンが期限切れになるように設定されている場合、90日ごとにアカウントを再接続する必要があります。更新のタイムアウトを91日以上にしたい場合は、 Snowflakeサポート に連絡する必要があります。タイムアウトは90日から最大1年に延長することができます。

必要条件

Snowflakeアカウントに接続してDataSetを作成するには、以下が必要です。
  • アカウントのフルネーム(Snowflakeにより提供)。これは、Snowflake URLの https://の 直後に続く部分です。 アカウントのフルネームには、アカウントがホストされる地域とクラウドプラットフォームを識別する追加のセグメントが含まれる場合があることに注意してください。以下の表に、クラウドプラットフォームまたは地域別のアカウント名の例を示します。各行に対して、アカウント名が「xy12345」であると仮定しています。
    Region.png
  • クライアントの登録時にSnowflakeから提供されたクライアントIDおよびクライアントシークレット。
重要 :Snowflakeでは以下の権限が必要です。
  • CREATE TABLE
  • COPY INTO
  • PUT
  • CREATE FILE FORMAT
  • REMOVE
  • LIST

接続を設定する

このセクションでは、 Snowflake OAuth Writeback コネクターページの [認証情報] および [詳細] ペインのオプションについて説明します。このページのほかのペインの項目である [スケジュール設定][DataSetに名前を付け、説明を入力] に関しては、ほとんどのタイプのコネクターで共通しています。詳細については、「 コネクターを使用してDataSetを追加する 」を参照してください。

[認証情報]ペイン

このペインには、Snowflakeアカウントに接続するための認証情報を入力するフィールドがあります。下の表は、各フィールドに必要な内容を説明しています。

フィールド

説明

Account Name

Snowflakeアカウント名を入力します。アカウント名を検索する方法については、「必要条件」を参照してください。

Client ID

クライアントの登録時にSnowflakeから提供されたクライアントIDを入力します。

Client Secret

クライアントの登録時にSnowflakeから提供されたクライアントシークレットを入力します。

Role 権限を入力します。
有効なSnowflake認証情報を一度入力しておくと、随時同じアカウントを使用して新しいDomo-Snowflake接続を作成できます。コネクターアカウントは、Data Centerの [アカウント] タブで管理できます。このタブの詳細については、「 コネクター/アダプターアカウントを管理する 」を参照してください。

[詳細]ペイン

このペインには、データを指定してデータの送信先を示すための多数のフィールドがあります。

メニュー

説明

Input DataSet ID

SnowflakeにコピーするDataSetのDataSet ID(GUID)を入力します。Data CenterでDataSetの詳細ビューを開き、URLの datasources/ に続く箇所で、IDを見つけることができます。例えば、URLが https://mycompany.domo.com/datasources/845305d8-da3d-4107-a9d6-13ef3f86d4a4/details/overview であれば、DataSet IDは 845305d8-da3d-4107-a9d6-13ef3f86d4a4 になります。

Select Table Name

データがコピーされるテーブルの命名方法を選択します。

  • Use Input DataSet GUID - テーブル名は、 [Input DataSet ID] に入力した番号になります。

  • Enter Table Name - [Custom Table Name] フィールドにテーブルのカスタム名を入力します。

Enter Table Name

データをコピーするSnowflakeテーブルの名前を入力します(スペースや特殊文字はアンダースコアに置き換えられます)。

Warehouses

データを送信したいテーブルが格納されているウェアハウスを選択します。

Databases

データを送信したいテーブルが格納されているデータベースを選択します。

Database Schema

取得したいデータが含まれているデータベーススキーマを選択します。

Use All Caps for Column Names and Table Name

[True]を選択すると、列名とテーブル名がすべて大文字で書き戻されます。そのため、Snowflakeでは大文字と小文字の区別がありません。この動作を回避するには[False]を選択します。

その他のペイン

スケジュール設定、再試行、更新に関するオプションなど、コネクターインターフェースのその他のペインに表示されるオプションについては、「 コネクターを使用してDataSetを追加する 」を参照してください。

よくある質問

このコネクターを使用すると、データをDomo DataSetからSnowflakeインスタンスに書き込むことができます。このコネクターは、Snowflakeのユーザー定義アプリを使用してOAuth認証をサポートします。
このエラーを避けるには、トークンを更新する必要があります。Snowflakeでは、アカウントが期限切れになるたびに手動でDomoアカウントを再接続する必要があります。アカウントの有効期限は、Snowflake統合によってコントロールされています。90日ごとに更新トークンが期限切れになるように設定されている場合、90日ごとにアカウントを再接続する必要があります。更新のタイムアウトを91日以上にしたい場合は、 Snowflakeサポート に連絡する必要があります。タイムアウトは90日から最大1年に延長することができます。
アカウントのフルネームと、クライアントの登録時にSnowflakeから提供されたクライアントIDおよびクライアントシークレットが必要です。自分の権限を入力することもできます。
制限は使用するサーバー構成によって異なります。
DataSetは15分ごとに実行できます。ただし、クエリの実行時間によっては、DataSetの実行頻度を低くする必要があります。
Domoの入力DataSet IDは、データのエクスポート元となるDataSetのURLで見つけることができます。例:https://customer.domo.com/datasources/ aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee /details/settings
Snowflakeデータベースに接続する前に、接続するポート上のデータベースサーバーにある多数のIPアドレスをホワイトリストに登録する必要があります。IPアドレスの詳細なリストは、「 DomoでIPアドレスをホワイトリストに登録する 」を参照してください。