Vous êtes ici :
Connexion Snowflake
Créez une connexion distante en utilisant le connecteur Snowflake afin de synchroniser des données depuis Snowflake vers CRM Analytics. Ce connecteur prend en charge la clé privée ou OAuth 2.0 pour l'authentification. L'utilisation d'OAuth 2.0 nécessite des étapes de configuration supplémentaires dans Snowflake et les identifiants Salesforce.
Connexion à Snowflake avec OAuth
Pour utiliser le connecteur Snowflake CRM Analytics avec une connexion OAuth, vous devez configurer Snowflake, Salesforce, CRM Analytics et un serveur d'autorisation OAuth externe.
Ces instructions générales vous aident à parcourir les étapes. Pensez à contacter votre service de sécurité réseau ou informatique pour obtenir une aide sur la configuration conforme aux exigences de sécurité de votre organisation.
- Configurez Snowflake et le serveur d'autorisation externe que vous avez sélectionné. L'aide Snowflake présente des instructions détaillées sur la connexion à des services tels que Okta.
- Lorsque le serveur d'autorisation est configuré, suivez les étapes présentées sous Définition d'un fournisseur d'authentification dans Salesforce dans Configuration d'un fournisseur d'authentification en utilisant OpenID Connect.
- Si vous utilisez Okta, suivez les instruction Okta pour ajouter leur service à Salesforce.
- Une fois le fournisseur d'authentification ajouté à Salesforce, définissez un identifiant nommé dans Salesforce. Sélectionnez le protocole d'authentification OAuth 2.0 et le type d'identité Principal nommé. L'utilisation d'identifiants externes n'est pas prise en charge.
- Vérifiez le flux OAuth en suivant les étapes des procédures de test Snowflake. Vous pouvez également vérifier depuis l'accès principal dans l'identifiant externe Salesforce. Cliquez sur Authentifier et assurez-vous que le Statut d'authentification est mis à jour sur Configuré.
- Ajoutez la connexion Snowflake. Pour le paramètre Type d’authentification, saisissez OAuth.
Détails de connexion
Générez votre clé privée et votre phrase secrète de clé privée Snowflake en utilisant la documentation Clé privée Snowflake. Si vous choisissez la rotation de votre clé privée Snowflake, mettez manuellement à jour les propriétés de connexion avec la nouvelle clé.
- Sous l'onglet Connexions du Gestionnaire de données, cliquez sur Nouvelle connexion.
- Cliquez sur le nom du connecteur, puis sur Suivant.
- Saisissez les paramètres du connecteur.
- Pour valider vos paramètres et tenter une connexion à la source, cliquez sur Enregistrer et tester. Si la connexion échoue, CRM Analytics indique les raisons possibles.
Tous les paramètres nécessitent une valeur, sauf indication contraire.
| Paramètre | Description |
|---|---|
| Nom de connexion | Identifie les connexions. Utilisez une convention permettant de différencier aisément les connexions. |
| Nom du développeur | Nom d'API de la connexion. Ce nom ne peut pas inclure d'espaces. Le nom d'API est utilisé dans vos recettes pour référencer les données extraites via cette connexion. Vous ne pouvez pas changer le nom du développeur une fois la connexion créée. |
| Description | Description |
| Username | Nom d'utilisateur du compte Snowflake. |
| Password | Paramètre* facultatif. Mot de passe de votre compte Snowflake. |
| Type d'authentification | Type d'authentification utilisé pour cette connexion. La valeur acceptée est « OAuth », « Password » ou « PrivateKey ». « PrivateKey » est recommandée comme option la plus sécurisée.
|
| Identifiant nommé | Le champ Nom d'un identifiant nommé stocké dans votre organisation Salesforce. |
| Clé privée | Paramètre* facultatif. Une clé privée associée à votre compte Snowflake. Remarque Vous devez utiliser une clé privée et un mot de passe cryptés générés avec la norme Advanced Encryption Standard (AES). Pour les étapes détaillées, consultez Authentification par paire de clés et rotation par paire de clés dans l'aide de Snowflake. Lors de l'utilisation de la commande openssl pour générer la clé cryptée, assurez-vous de remplacer des3 par aes256 pour vous assurer que le cryptage avancé est utilisé. |
| Phrase secrète de clé privée | Paramètre* facultatif. La phrase secrète associée à la clé privée que vous avez spécifiée. |
| Account | Nom de votre compte Snowflake. Le nom du compte est le premier segment du domaine dans votre URL Snowflake. Par exemple, 123abc est le nom de votre compte dans https://123abc.snowflakecomputing.com. |
| Warehouse | Nom de l'entrepôt Snowflake. Ce paramètre est sensible à la casse. Par conséquent, saisissez la valeur telle qu'elle est affichée dans Snowflake. |
| Rôle | Paramètre facultatif. Rôle Snowflake attribué à l'utilisateur au nom duquel vous vous connectez. |
| Additional JDBC URL Parameters | Paramètre facultatif. Un ou plusieurs paramètres de connexion JDBC. Saisissez-le sous le format : parameter1=value;parameter2=value;parameter3=value Par exemple : user=joates;warehouse=mywh;db=mydb&schema=public |
| Database | Nom de la base de données Snowflake. Ce paramètre est sensible à la casse. Par conséquent, saisissez la valeur telle qu'elle est affichée dans Snowflake. |
| Schéma | Nom du schéma Snowflake. Ce paramètre est sensible à la casse. Par conséquent, saisissez la valeur telle qu'elle est affichée dans Snowflake. |
*Saisissez le Mot de passe ou bien la Clé privée et la ¨Phrase secrète de clé privée. Pour plus d'informations sur les clés privées, consultez la documentation Clé privée Snowflake.
Filtrage des données synchronisées vers CRM Analytics
Excluez les données inutiles ou confidentielles de la synchronisation vers CRM Analytics à l'aide de filtres de synchronisation des données. Les filtres sont exécutés sur l'objet source et accélèrent la synchronisation des données, car ils extraient uniquement les données des objets dont vous avez besoin dans CRM Analytics. Si vous envisagez d’utiliser les données exclues, au lieu d'un filtre de synchronisation des données, utilisez un filtre de recette pour limiter les données écrites dans un jeu de données.
- Dans le Gestionnaire de données, cliquez sur l'onglet Connexions.
- Sélectionnez la connexion associée à l'objet à filtrer.
- Cliquez sur le nom de l'objet à filtrer.
- Cliquez sur Filtre Data Sync.
- Saisissez le filtre.
- Cliquez sur Enregistrer.
Pour le connecteur Snowflake, saisissez un filtre SQL en suivant la documentation WHERE Snowflake.
Lors de l'utilisation du connecteur Snowflake, tenez compte des comportements ci-dessous.
- Les noms d'objets connectés doivent commencer par une lettre, et contenir uniquement des lettres, des chiffres ou des traits de soulignement. Les noms d'objet ne peuvent pas se terminer par un trait de soulignement.
- Seuls les noms de champ qui combinent des caractères alphanumériques, point, trait de soulignement ou tiret sont pris en charge. Si un connecteur contient des noms de champ avec d'autres caractères spéciaux, par exemple des espaces ou des crochets, la synchronisation échoue.
- Des erreurs d'arrondi peuvent se produire dans les valeurs en virgule flottante lorsque Snowflake effectue la requête qui envoie les données au connecteur. Pour plus d'informations, consultez l'aide Snowflake Types de données en virgule flottante. Si un ID est spécifié en tant que nombre à virgule flottante dans Snowflake, ces erreurs peuvent entraîner l'envoi d'ID incorrects au connecteur. Utilisez le type de données NUMBER ou équivalent pour les ID dans Snowflake.
- Le connecteur peut synchroniser jusqu'à 100 millions de lignes ou 50 Go par objet, selon la première limite atteinte. Lors de l'utilisation du connecteur, les données de l'organisation Salesforce Government Cloud sont protégées en transit avec le cryptage avancé et peuvent synchroniser jusqu'à 10 millions de lignes ou 5 Go pour chaque objet connecté, selon la première limite atteinte.
- Un entrepôt Snowflake peut être défini pour reprendre ou suspendre automatiquement. Pour plus d'informations sur l'utilisation optimale de ces fonctionnalités, consultez la documentation Snowflake.
- L'identifiant nommé doit utiliser le type d'identité Principal nommé et avoir le statut Authentifié.
- Lors de l'utilisation de la version héritée du connecteur Snowflake, les paramètres Clé privée et Phrase secrète de clé privée ne sont pas utilisés. La propriété Mot de passe est requise.
