Passer au contenu principal
Le connecteur Snowflake est disponible exclusivement sur le plan Enterprise.
Les Warehouse Connectors permettent à Replit Agent d’interroger les entrepôts de données de votre organisation. Avec le connecteur Snowflake, les développeurs peuvent créer des tableaux de bord, des outils de reporting et des applications de données en langage naturel — sans expertise SQL requise. La configuration est un processus unique qui nécessite un administrateur Snowflake et un administrateur d’espace de travail Replit. Une fois configuré, tout membre de l’organisation peut se connecter et commencer à créer avec les données Snowflake. Ce guide vous accompagne tout au long de la configuration complète. Trois rôles sont impliqués :
  1. Snowflake Account Admin — Crée l’intégration OAuth dans Snowflake
  2. Replit Workspace Admin — Configure le connecteur dans Replit
  3. Builder — Se connecte et commence à créer

Créer l’intégration OAuth dans Snowflake

Le Snowflake Account Admin crée une intégration de sécurité OAuth qui permet à Replit de s’authentifier auprès de Snowflake.

Prérequis

  • Rôle ACCOUNTADMIN dans Snowflake
  • Accès pour exécuter du SQL dans les feuilles de calcul Snowflake

Exécuter le script de configuration

1

Se connecter à Snowflake

Ouvrez votre compte Snowflake et assurez-vous d’utiliser le rôle ACCOUNTADMIN. Vous pouvez le vérifier dans le menu déroulant des rôles en haut à droite.
2

Ouvrir une feuille de calcul SQL

Cliquez sur Worksheets dans la barre latérale gauche et créez une nouvelle feuille de calcul.
3

Exécuter le script d'intégration OAuth

Copiez et collez le script SQL suivant, puis exécutez-le :
Create OAuth integration
-- Drop existing integration if needed
DROP INTEGRATION IF EXISTS REPLIT_OAUTH;

-- Create OAuth integration for Replit
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';
L’URI de redirection doit être exactement https://replit.com/connectors/oauth/callback. Toute autre valeur entraîne une erreur 404 lors de l’authentification.
Définir BLOCKED_ROLES_LIST = () garantit qu’aucun rôle n’est bloqué pour l’utilisation de l’intégration. Sans cela, vous pourriez obtenir des erreurs « invalid consent request » ou « role blocked » lors de la connexion.
4

Récupérer vos identifiants OAuth

Exécutez cette requête pour obtenir le Client ID et le Client Secret :
Get OAuth credentials
-- View integration details
DESCRIBE INTEGRATION REPLIT_OAUTH;

-- Get Client ID and Secret
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;
Copiez le Client ID et le Client Secret depuis le résultat. Vous en aurez besoin pour l’étape suivante.

Configurer le connecteur dans Replit

Le Replit Workspace Admin ajoute les identifiants Snowflake dans Replit. Une fois configuré, toute personne de l’organisation peut se connecter.
Cette étape nécessite un plan Enterprise avec un accès administrateur.
1

Ouvrir les Intégrations

Accédez aux paramètres de votre organisation et sélectionnez l’onglet Integrations.
2

Ajouter le connecteur Snowflake

Cliquez sur Add New Connector et sélectionnez Snowflake.
3

Saisir les identifiants

Fournissez le Client ID et le Client Secret de l’étape précédente.
4

Définir la portée

Définissez la portée du connecteur sur refresh_token.
Utilisez uniquement la portée refresh_token. D’autres portées comme session:role-any ou session:role:PUBLIC peuvent provoquer une erreur « invalid scope ».
5

Enregistrer

Cliquez sur Save pour activer le connecteur.

Se connecter à Snowflake

Tout membre de l’organisation ayant accès au connecteur peut se connecter. Connectez-vous depuis la page Integrations d’abord pour vérifier la connexion avant de l’utiliser avec Agent.
1

Trouver le connecteur Snowflake

Accédez à Integrations dans Replit. Sous Connectors, trouvez Snowflake.
2

Cliquer sur Sign In

Cliquez sur Sign In sur le connecteur Snowflake.
3

Entrer votre Account ID Snowflake

L’invite OAuth demande votre Account ID Snowflake.Pour trouver votre Account ID, regardez votre URL Snowflake :
https://app.snowflake.com/myorg/myaccount
Prenez les deux parties après app.snowflake.com/ et joignez-les avec un trait d’union :
myorg-myaccount
L’URL utilise un / entre les deux parties, mais l’Account ID utilise un - à la place.
4

S'authentifier

Snowflake vous redirige vers la page de connexion. Entrez vos identifiants Snowflake pour compléter le flux OAuth.

Commencer à créer avec vos données Snowflake

Après la connexion, vous pouvez utiliser le connecteur Snowflake avec Agent de deux façons :
  • Commande slash — Tapez /snowflake dans l’invite pour utiliser le connecteur
  • Langage naturel — Demandez directement à Agent d’utiliser vos données Snowflake
Voici un exemple d’invite :
Build me a dashboard using my Snowflake data. Show total revenue
by region with a bar chart, a trend line by quarter, and a table
of top 10 customers. Dark theme, clean and modern.
Agent écrit et exécute des requêtes SQL sur vos données Snowflake et crée une application fonctionnelle.

Dépannage

Votre intégration Snowflake peut avoir des rôles bloqués par défaut.Vérifiez que votre intégration a été créée avec BLOCKED_ROLES_LIST = (). Si vous l’avez déjà créée sans ce paramètre, exécutez :
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';
Si l’erreur persiste, vérifiez que votre rôle par défaut n’est pas bloqué :
Set default role
ALTER USER "YOUR_USERNAME" SET DEFAULT_ROLE = 'PUBLIC';
Vérifiez que l’URI de redirection dans votre intégration Snowflake est exactement :
https://replit.com/connectors/oauth/callback
Toute différence provoque une erreur 404 lors du flux OAuth.
Assurez-vous que la portée du connecteur dans Replit est définie sur refresh_token uniquement. Supprimez toute autre portée comme session:role-any ou session:role:PUBLIC.
Vérifiez que le Client ID et le Client Secret dans Replit correspondent à ce que Snowflake a généré. Revérifiez en exécutant :
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;

Documentation associée