Snowflakeコネクタ

SnowflakeコネクタはEnterpriseプランでのみご利用いただけます。

ウェアハウスコネクタにより、Replit Agentは組織のデータウェアハウスにクエリを実行できます。Snowflakeコネクタを使用すると、ビルダーは自然言語を使用してダッシュボード、レポートツール、データアプリケーションを作成できます — SQLの専門知識は不要です。セットアップはSnowflake管理者とReplitワークスペース管理者が必要な一度きりのプロセスです。設定が完了すると、組織のメンバー全員がサインインしてSnowflakeデータで構築を始めることができます。このガイドでは完全なセットアップの手順を説明します。3つの役割が関与します：

Snowflakeアカウント管理者 — SnowflakeでOAuth統合を作成します
Replitワークスペース管理者 — Replitでコネクタを設定します
ビルダー — サインインして構築を開始します

SnowflakeでOAuth統合を作成する

SnowflakeアカウントadminはReplitがSnowflakeで認証できるOAuthセキュリティ統合を作成します。

前提条件

SnowflakeのACCOUNTADMINロール
SnowflakeワークシートでSQLを実行できるアクセス権

セットアップスクリプトを実行する

Snowflakeにログインする

Snowflakeアカウントを開き、ACCOUNTADMINロールを使用していることを確認します。右上のロールドロップダウンで確認できます。

SQLワークシートを開く

左サイドバーのWorksheetsをクリックして新しいワークシートを作成します。

OAuth統合スクリプトを実行する

以下のSQLスクリプトをコピーして貼り付け、実行します：

Create OAuth integration

-- 既存の統合を削除（必要な場合）
DROP INTEGRATION IF EXISTS REPLIT_OAUTH;

-- Replit用のOAuth統合を作成
CREATE SECURITY INTEGRATION REPLIT_OAUTH
  TYPE = OAUTH
  ENABLED = TRUE
  OAUTH_CLIENT = CUSTOM
  OAUTH_CLIENT_TYPE = 'CONFIDENTIAL'
  OAUTH_REDIRECT_URI = 'https://replit.com/connectors/oauth/callback'
  OAUTH_ISSUE_REFRESH_TOKENS = TRUE
  OAUTH_REFRESH_TOKEN_VALIDITY = 7776000
  OAUTH_ALLOW_NON_TLS_REDIRECT_URI = FALSE
  BLOCKED_ROLES_LIST = ()
  COMMENT = 'OAuth integration for Replit connector';

リダイレクトURIは正確にhttps://replit.com/connectors/oauth/callbackである必要があります。他の値を使用すると、認証中に404エラーが発生します。

BLOCKED_ROLES_LIST = ()を設定すると、統合の使用からロールがブロックされないことが保証されます。この設定がないと、接続時に「invalid consent request」または「role blocked」エラーが発生する場合があります。

OAuth認証情報を取得する

このクエリを実行してクライアントIDとクライアントシークレットを取得します：

Get OAuth credentials

-- 統合の詳細を表示
DESCRIBE INTEGRATION REPLIT_OAUTH;

-- クライアントIDとシークレットを取得
WITH secrets AS (
  SELECT PARSE_JSON(
    SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('REPLIT_OAUTH')
  ) as creds
)
SELECT
  creds:OAUTH_CLIENT_ID::STRING as CLIENT_ID,
  creds:OAUTH_CLIENT_SECRET::STRING as CLIENT_SECRET
FROM secrets;

出力からClient IDとClient Secretをコピーします。次のステップでこれらが必要になります。

Replitでコネクタを設定する

ReplitワークスペースadminがSnowflakeの認証情報をReplitに追加します。設定が完了すると、組織内の誰でもサインインできます。

このステップにはエンタープライズプランと管理者アクセスが必要です。

Integrationsを開く

組織の設定に移動してIntegrationsタブを選択します。

Snowflakeコネクタを追加する

Add New ConnectorをクリックしてSnowflakeを選択します。

認証情報を入力する

前のステップのClient IDとClient Secretを入力します。

スコープを設定する

コネクタのスコープをrefresh_tokenに設定します。

refresh_tokenスコープのみを使用してください。session:role-anyやsession:role:PUBLICなどの他のスコープは「invalid scope」エラーを引き起こす場合があります。

保存する

Saveをクリックしてコネクタを有効にします。

Snowflakeにサインインする

コネクタへのアクセス権を持つ組織メンバーはサインインできます。Agentで使用する前に接続を確認するために、まずIntegrationsページからサインインします。

Snowflakeコネクタを見つける

ReplitのIntegrationsに移動します。Connectorsの下でSnowflakeを見つけます。

Sign Inをクリックする

SnowflakeコネクタのSign Inをクリックします。

SnowflakeアカウントIDを入力する

OAuthプロンプトでSnowflakeアカウントIDを求められます。アカウントIDを見つけるには、SnowflakeのURLを確認します：

https://app.snowflake.com/myorg/myaccount

app.snowflake.com/の後の2つの部分をハイフンで結合します：

myorg-myaccount

URLでは2つの部分の間に/が使用されていますが、アカウントIDでは-を使用します。

認証する

Snowflakeがログインページにリダイレクトします。OAuthフローを完了するためにSnowflakeの認証情報を入力します。

Snowflakeデータで構築を始める

接続後、2つの方法でAgentとSnowflakeコネクタを使用できます：

スラッシュコマンド — プロンプトに/snowflakeと入力してコネクタを使用します
自然言語 — AgentにSnowflakeデータを使用するよう直接依頼します

プロンプトの例：

Snowflakeデータを使ってダッシュボードを作成してください。地域別の総収益を棒グラフで、四半期別のトレンドラインで、上位10顧客の表で表示してください。ダークテーマ、クリーンでモダンなデザインで。

Agentはお客様のSnowflakeデータに対してSQLクエリを作成・実行し、動作するアプリケーションを構築します。

トラブルシューティング

Snowflake統合でロールがデフォルトでブロックされている可能性があります。統合がBLOCKED_ROLES_LIST = ()で作成されたことを確認します。この設定なしで既に作成した場合は、次を実行します：

Fix blocked roles

CREATE OR REPLACE SECURITY INTEGRATION REPLIT_OAUTH
  TYPE = OAUTH
  ENABLED = TRUE
  OAUTH_CLIENT = CUSTOM
  OAUTH_CLIENT_TYPE = 'CONFIDENTIAL'
  OAUTH_REDIRECT_URI = 'https://replit.com/connectors/oauth/callback'
  OAUTH_ISSUE_REFRESH_TOKENS = TRUE
  OAUTH_REFRESH_TOKEN_VALIDITY = 7776000
  OAUTH_ALLOW_NON_TLS_REDIRECT_URI = FALSE
  BLOCKED_ROLES_LIST = ()
  COMMENT = 'OAuth integration for Replit connector';

エラーが続く場合は、デフォルトロールがブロックされていないことを確認します：

Set default role

ALTER USER "YOUR_USERNAME" SET DEFAULT_ROLE = 'PUBLIC';

認証時に404エラー

Snowflake統合のリダイレクトURIが正確に以下であることを確認します：

https://replit.com/connectors/oauth/callback

不一致がある場合、OAuthフロー中に404エラーが発生します。

invalid scopeエラー

Replitのコネクタスコープがrefresh_tokenのみに設定されていることを確認します。session:role-anyやsession:role:PUBLICなどの他のスコープを削除してください。

Failed to connectエラー

ReplitのクライアントIDとクライアントシークレットがSnowflakeが生成したものと一致することを確認します。以下を実行して再確認します：

Verify credentials

WITH secrets AS (
  SELECT PARSE_JSON(
    SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('REPLIT_OAUTH')
  ) as creds
)
SELECT
  creds:OAUTH_CLIENT_ID::STRING as CLIENT_ID,
  creds:OAUTH_CLIENT_SECRET::STRING as CLIENT_SECRET
FROM secrets;

Enterprise

コネクタ

Warehouse Connectors

Developer Integrations

ID とアクセス管理

デザインシステムとテンプレート

エンタープライズ請求

Snowflakeコネクタ

SnowflakeでOAuth統合を作成する

前提条件

セットアップスクリプトを実行する

Replitでコネクタを設定する

Snowflakeにサインインする

Snowflakeデータで構築を始める

トラブルシューティング

関連ドキュメント

​SnowflakeでOAuth統合を作成する

​前提条件

​セットアップスクリプトを実行する

​Replitでコネクタを設定する

​Snowflakeにサインインする

​Snowflakeデータで構築を始める

​トラブルシューティング

​関連ドキュメント

SnowflakeでOAuth統合を作成する

前提条件

セットアップスクリプトを実行する

Replitでコネクタを設定する

Snowflakeにサインインする

Snowflakeデータで構築を始める

トラブルシューティング

関連ドキュメント