Connecteurs Snowflake

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 :

Administrateur de compte Snowflake — Crée l’intégration OAuth dans Snowflake
Administrateur d’espace de travail Replit — Configure le connecteur dans Replit
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

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.

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.

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.

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.

Ouvrir les Intégrations

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

Ajouter le connecteur Snowflake

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

Entrer les identifiants

Fournissez l’identifiant client et le secret client de l’étape précédente.

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 ».

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.

Trouver le connecteur Snowflake

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

Cliquer sur Se connecter

Cliquez sur Se connecter sur le connecteur Snowflake.

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.

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

Erreur de requête de consentement invalide ou de rôle bloqué

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';

Erreur 404 lors de l'authentification

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.

Erreur de portée invalide

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.

Erreur de connexion échouée

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

Vue d’ensemble des connecteurs d’entrepôt — Vue d’ensemble de tous les connecteurs d’entrepôt pris en charge
Connecter Databricks — Configuration Databricks étape par étape
Gestion de vos connecteurs — Gestion et configuration des connecteurs
Snowflake — Configurer OAuth pour les clients personnalisés — Documentation OAuth de Snowflake

Entreprise

Connecteurs

Warehouse Connectors

Developer Integrations

Gestion des identités et des accès

Systèmes de design et modèles

Facturation entreprise

Connecteurs Snowflake

Créer l’intégration OAuth dans Snowflake

Prérequis

Exécuter le script de configuration

Configurer le connecteur dans Replit

Se connecter à Snowflake

Commencer à créer avec vos données Snowflake

Résolution des problèmes

Documentation associée

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

​Prérequis

​Exécuter le script de configuration

​Configurer le connecteur dans Replit

​Se connecter à Snowflake

​Commencer à créer avec vos données Snowflake

​Résolution des problèmes

​Documentation associée

Créer l’intégration OAuth dans Snowflake

Prérequis

Exécuter le script de configuration

Configurer le connecteur dans Replit

Se connecter à Snowflake

Commencer à créer avec vos données Snowflake

Résolution des problèmes

Documentation associée