Passer au contenu principal

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.

Le connecteur Snowflake est disponible exclusivement sur le plan Enterprise.
Les connecteurs d’entrepôt permettent à Replit Agent d’interroger les entrepôts de données de votre organisation. Avec le connecteur Snowflake, les créateurs peuvent concevoir des tableaux de bord, des outils de reporting et des applications de données en langage naturel — aucune 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 des données Snowflake. Ce guide vous guide tout au long de la configuration complète. Trois rôles sont impliqués :
  1. Administrateur de compte Snowflake — Crée l’intégration OAuth dans Snowflake
  2. Administrateur d’espace de travail Replit — Configure le connecteur dans Replit
  3. Créateur — Se connecte et commence à créer

​
Créer l’intégration OAuth dans Snowflake

L’administrateur de compte Snowflake crée une intégration de sécurité OAuth qui permet à Replit de s’authentifier avec 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 dans le coin supérieur droit.
2

Ouvrir une feuille de calcul SQL

Cliquez sur Feuilles de calcul 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 et exécutez-le :
Create OAuth integration
-- Supprimer l'intégration existante si nécessaire
DROP INTEGRATION IF EXISTS REPLIT_OAUTH;

-- Créer l'intégration OAuth pour 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 provoque une erreur 404 lors de l’authentification.
Définir BLOCKED_ROLES_LIST = () garantit qu’aucun rôle n’est bloqué pour utiliser l’intégration. Sans cela, vous pourriez obtenir des erreurs « requête de consentement invalide » ou « rôle bloqué » lors de la connexion.
4

Récupérer vos identifiants OAuth

Exécutez cette requête pour obtenir l’identifiant client et le secret client :
Get OAuth credentials
-- Voir les détails de l'intégration
DESCRIBE INTEGRATION REPLIT_OAUTH;

-- Obtenir l'identifiant client et le 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 l’identifiant client et le secret client depuis la sortie. Vous en aurez besoin pour l’étape suivante.

​
Configurer le connecteur dans Replit

L’administrateur d’espace de travail Replit ajoute les identifiants Snowflake à Replit. Une fois configuré, toute personne de l’organisation peut se connecter.
Cette étape nécessite un plan Enterprise avec accès administrateur.
1

Ouvrir les Intégrations

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

Ajouter le connecteur Snowflake

Cliquez sur Ajouter un nouveau connecteur et sélectionnez Snowflake.
3

Entrer les identifiants

Fournissez l’identifiant client et le secret client 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 « portée invalide ».
5

Enregistrer

Cliquez sur Enregistrer 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 Intégrations pour vérifier la connexion avant de l’utiliser avec Agent.
1

Trouver le connecteur Snowflake

Accédez aux Intégrations dans Replit. Sous Connecteurs, trouvez Snowflake.
2

Cliquer sur Se connecter

Cliquez sur Se connecter sur le connecteur Snowflake.
3

Entrer votre identifiant de compte Snowflake

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

S'authentifier

Snowflake vous redirige vers la page de connexion. Entrez vos identifiants Snowflake pour terminer 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 manières :
  • Commande slash — Tapez /snowflake dans l’invite pour utiliser le connecteur
  • Langage naturel — Demandez à Agent d’utiliser vos données Snowflake directement
Voici un exemple d’invite : 
Construis-moi un tableau de bord avec mes données Snowflake. Montre le chiffre
d'affaires total par région avec un graphique en barres, une courbe de tendance
par trimestre et un tableau des 10 meilleurs clients. Thème sombre, propre et moderne.
Agent écrit et exécute des requêtes SQL sur vos données Snowflake et crée une application fonctionnelle.

​
Résolution des problèmes

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 incompatibilité 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 l’identifiant client et le secret client dans Replit correspondent à ce que Snowflake a généré. Vérifiez à nouveau 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