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

Documentation Index

Fetch the complete documentation index at: https://docs.replit.com/llms.txt

Use this file to discover all available pages before exploring further.

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

SnowflakeでOAuth統合を作成する

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

前提条件

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

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

1

Snowflakeにログインする

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

SQLワークシートを開く

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

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」エラーが発生する場合があります。
4

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 IDClient Secretをコピーします。次のステップでこれらが必要になります。

Replitでコネクタを設定する

ReplitワークスペースadminがSnowflakeの認証情報をReplitに追加します。設定が完了すると、組織内の誰でもサインインできます。
このステップにはエンタープライズプランと管理者アクセスが必要です。
1

Integrationsを開く

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

Snowflakeコネクタを追加する

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

認証情報を入力する

前のステップのClient IDClient Secretを入力します。
4

スコープを設定する

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

保存する

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

Snowflakeにサインインする

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

Snowflakeコネクタを見つける

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

Sign Inをクリックする

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

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

OAuthプロンプトでSnowflakeアカウントIDを求められます。アカウントIDを見つけるには、SnowflakeのURLを確認します:
https://app.snowflake.com/myorg/myaccount
app.snowflake.com/の後の2つの部分をハイフンで結合します:
myorg-myaccount
URLでは2つの部分の間に/が使用されていますが、アカウントIDでは-を使用します。
4

認証する

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

Snowflakeデータで構築を始める

接続後、2つの方法でAgentとSnowflakeコネクタを使用できます:
  • スラッシュコマンド — プロンプトに/snowflakeと入力してコネクタを使用します
  • 自然言語 — AgentにSnowflakeデータを使用するよう直接依頼します
プロンプトの例:
Snowflakeデータを使ってダッシュボードを作成してください。地域別の総収益を棒グラフで、四半期別のトレンドラインで、上位10顧客の表で表示してください。ダークテーマ、クリーンでモダンなデザインで。
Agentはお客様のSnowflakeデータに対してSQLクエリを作成・実行し、動作するアプリケーションを構築します。

トラブルシューティング

Snowflake統合のリダイレクトURIが正確に以下であることを確認します:
https://replit.com/connectors/oauth/callback
不一致がある場合、OAuthフロー中に404エラーが発生します。
Replitのコネクタスコープがrefresh_tokenのみに設定されていることを確認します。session:role-anysession:role:PUBLICなどの他のスコープを削除してください。
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;

関連ドキュメント