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.

Autoriser le trafic du connecteur lorsque des restrictions réseau s’appliquent

Si votre compte Snowflake restreint l’accès par adresse IP, demandez à votre administrateur Snowflake de vérifier la politique réseau de REPLIT_OAUTH. La connexion via le navigateur et les requêtes du connecteur suivent des politiques réseau différentes :

La connexion via le navigateur utilise la politique réseau de l’utilisateur Snowflake, ou la politique du compte s’il n’existe pas de politique utilisateur.
Les demandes de jeton et les requêtes du connecteur utilisent la politique réseau de l’intégration de sécurité OAuth, ou la politique du compte s’il n’existe pas de politique d’intégration.

Une connexion réussie via le navigateur ne confirme pas que Snowflake autorise les requêtes provenant du connecteur. Replit ne publie pas de liste d’adresses IP statiques pour les connecteurs. Contactez le support Replit ou votre équipe de compte pour obtenir les adresses IP sortantes actuelles du connecteur Snowflake avant de mettre à jour votre liste d’autorisation. Demandez à votre administrateur Snowflake de créer ou de vérifier une politique réseau qui autorise ces adresses et répond aux exigences de sécurité de votre organisation. Pour associer cette politique à l’intégration OAuth existante, remplacez YOUR_CONNECTOR_NETWORK_POLICY par son nom :

Set OAuth network policy

ALTER SECURITY INTEGRATION REPLIT_OAUTH
  SET NETWORK_POLICY = 'YOUR_CONNECTOR_NETWORK_POLICY';

Une politique au niveau de l’intégration prévaut sur la politique du compte pour ces requêtes du connecteur. Conservez vos politiques de compte et d’utilisateur ; ne désactivez pas les restrictions réseau pour résoudre un problème. Consultez les recommandations de Snowflake sur la politique réseau OAuth pour plus de détails.

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

Sélectionnez l’espace de travail de votre organisation, puis accédez à Intégrations dans Paramètres.

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

Si la connexion via le navigateur réussit mais que le connecteur ne parvient pas à se connecter, des restrictions réseau peuvent encore bloquer les requêtes du connecteur. Demandez à votre administrateur Snowflake de vérifier la politique de REPLIT_OAUTH, et pas seulement la politique de l’utilisateur ou du compte. Suivez la section Autoriser le trafic du connecteur lorsque des restrictions réseau s’appliquent, puis essayez de vous reconnecter au connecteur.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

Overview

Workspace Essentials

Entreprise

Warehouse Connectors

Gestion des identités et des accès

Facturation entreprise

Connecteurs Snowflake

Créer l’intégration OAuth dans Snowflake

Prérequis

Exécuter le script de configuration

Autoriser le trafic du connecteur lorsque des restrictions réseau s’appliquent

Configurer le connecteur dans Replit

Se connecter à Snowflake

Commencer à créer avec vos données Snowflake

Résolution des problèmes

Documentation associée