Avant de créer un flux dans Datastream, vous devez configurer des profils de connexion qui stockent les paramètres d'authentification et de connectivité réseau réutilisables pour les ressources de la même région.
Vous pouvez créer des profils de connexion source pour Oracle, MySQL, PostgreSQL, SQL Server, MongoDB, Spanner, Salesforce, Salesforce Marketing Cloud, ServiceNow, Microsoft Dataverse ou Workday. Pour les destinations, vous pouvez créer des profils de connexion pour des ensembles de données BigQuery ou un bucket Cloud Storage.
Avant de commencer
- Assurez-vous d'avoir configuré votre base de données source pour la réplication. Pour en savoir plus sur les étapes requises pour chaque type de source compatible, consultez Configurer des sources.
- Découvrez les étapes à suivre pour configurer la destination sélectionnée. Pour en savoir plus, consultez Configurer des destinations.
Créer un profil de connexion pour la base de données Oracle
Accédez à la page Profils de connexion de la console Google Cloud .
Cliquez sur CRÉER UN PROFIL.
Sur la page Créer un profil de connexion, cliquez sur le type de profil Oracle.
Utilisez le tableau suivant pour renseigner les champs de la section Définir les paramètres de connexion de la page Créer un profil Oracle :
Champ Description Nom du profil de connexion Saisissez le nom à afficher du profil de connexion à la base de données Oracle source. Ce nom est utilisé dans la liste des profils de connexion, ainsi que lorsqu'un profil de connexion existant est sélectionné lors de la création d'un flux. ID du profil de connexion Datastream remplit automatiquement ce champ en fonction du nom du profil de connexion que vous saisissez. Vous pouvez conserver l'ID généré automatiquement ou le modifier. Région Sélectionnez la région dans laquelle le profil de connexion est stocké. Comme toutes les ressources, les profils de connexion sont enregistrés dans une région. Un flux ne peut utiliser que des profils de connexion stockés dans la même région que lui. La sélection de la région n'affecte pas la capacité de Datastream de se connecter à la source ou à la destination, mais peut affecter la disponibilité si la région subit un temps d'arrêt. Nom d'hôte ou adresse IP Saisissez un nom d'hôte ou une adresse IP que Datastream peut utiliser pour se connecter à la base de données Oracle source.
Si vous utilisez une connectivité privée pour communiquer avec la base de données source, spécifiez l'adresse IP privée (interne) de la base de données source.
Pour les autres méthodes de connectivité, telles que la liste d'autorisation d'adresses IP, indiquez l'adresse IP publique.
Port Saisissez le numéro de port réservé à la base de données source (le port par défaut est généralement 1521). Username (Nom d'utilisateur) Saisissez le nom d'utilisateur du compte de la base de données source (par exemple, ROOT). Il s'agit de l'utilisateur Datastream que vous avez créé pour la base de données.Pour en savoir plus sur la création de cet utilisateur, consultez Configurer votre base de données Oracle source.
Sélectionner le mot de passe de Secret Manager Sélectionnez cette option si vous souhaitez vous authentifier avec un secret plutôt que de saisir le mot de passe manuellement. Lorsque vous sélectionnez cette option, deux menus déroulants s'affichent : - Secret : vous pouvez sélectionner un secret dans la liste (si disponible), le saisir manuellement ou en créer un : Pour saisir un secret manuellement :
- Cliquez sur Saisir le secret manuellement. La boîte de dialogue Ajouter un secret via un ID de ressource s'affiche.
- Copiez et collez l'identifiant de ressource de votre secret depuis Secret Manager. L'ID de ressource du secret peut avoir le format suivant :
projects/PROJECT_NUMBER/secrets/SECRET_NAME(dernière version)projects/PROJECT_NUMBER/secrets/SECRET_NAME/versions/VERSION_NUMBER(version spécifique)- Cliquez sur le bouton Ajouter un secret.
- Cliquez sur Créer un secret. Le panneau latéral Détails du secret s'ouvre.
- Sous Nom, saisissez un nom pour le secret (par exemple,
my-secret). Un nom de secret peut contenir des lettres majuscules et minuscules, des chiffres, des traits d'union et des traits de soulignement. La longueur maximale autorisée pour un nom est de 255 caractères. Le nom que vous créez est ajouté à l'identifiant de la ressource de secret. - Facultatif : Si vous souhaitez également ajouter une version lors de la création du secret initial, saisissez une valeur pour le secret dans le champ Valeur du secret (par exemple,
abcd1234). La valeur du secret peut être indiquée dans n'importe quel format, mais elle ne doit pas dépasser 64 Kio. Vous pouvez également importer un fichier texte contenant la valeur du secret à l'aide de l'option Importer un fichier. - Cliquez sur le bouton Créer un secret.
- Version du secret : saisissez la version du secret que vous souhaitez utiliser :
- Lorsque vous fournissez l'identifiant de la ressource du secret, la case Utiliser la dernière version s'affiche. Vous pouvez la sélectionner pour utiliser la version la plus récente de votre ressource de secret.
- Vous pouvez également développer le menu déroulant Version du secret et sélectionner la version dans la liste, si elle est disponible.
- Si vous souhaitez utiliser une autre version du secret, procédez comme suit :
- Cliquez sur Ajouter une version.
- Dans le champ Valeur du secret, saisissez une valeur pour le secret. Vous pouvez également importer un fichier contenant la valeur du secret.
- Cliquez sur le bouton Ajouter une nouvelle version.
Saisir le mot de passe manuellement Vous pouvez également saisir manuellement le mot de passe du compte de la base de données source.
Identifiant système (SID) Saisissez le service qui garantit que la base de données Oracle source est protégée et surveillée. Pour les bases de données Oracle, le service de base de données est généralement ORCL. Pour les bases de données connectables, le SID est le nom de la base de données connectable. Activer l'accès ASM pour le lecteur binaire Cochez cette case si vous stockez vos journaux Oracle dans la gestion automatique de l'espace de stockage (ASM). Cette case ne s'applique qu'à la méthode CDC de lecteur de journal binaire (bêta). Si vous sélectionnez cette option, vous devez indiquer les détails de connexion de votre instance ASM, y compris le nom du service ASM. Le compte utilisateur de la connexion ASM doit disposer du droit SYSASM. Pour en savoir plus sur les méthodes CDC disponibles, consultez Utiliser les fichiers journaux de rétablissement de base de données Oracle.Vous pouvez également utiliser des libellés pour organiser vos ressources DataStream.
- Pour créer un libellé, cliquez sur AJOUTER UN LIBELLÉ, puis saisissez la paire clé-valeur du libellé.
- Pour supprimer le libellé, cliquez sur l'icône de corbeille à droite de la ligne correspondant au libellé.
Dans la section Définir les paramètres de connexion, cliquez sur CONTINUER. La page Sécuriser votre connexion à la source est active.
Dans le menu Type de chiffrement, sélectionnez l'une des options suivantes :
Type de chiffrement Description Aucun Datastream se connecte à la base de données source sans chiffrement. Serveur uniquement Lorsque Datastream se connecte à la base de données source, il authentifie la source et s'assure qu'elle se connecte à l'hôte correct de manière sécurisée. Cela empêche les attaques dites MITM.
Pour l'authentification serveur uniquement, la source n'authentifie pas Datastream. Pour utiliser l'authentification serveur uniquement, vous devez fournir le certificat X.509 de l'autorité de certification qui a signé le certificat du serveur, encodé au format PEM. Veillez à utiliser un seul certificat, car Datastream n'accepte pas les chaînes de certificats.
Dans la section Sécurisez votre connexion à la source, cliquez sur CONTINUER. La section Définir la méthode de connectivité de la page Créer un profil Oracle est active.
Dans le menu déroulant Méthode de connectivité, sélectionnez une méthode de connectivité réseau. Cette méthode définit la manière dont Datastream se connecte à la base de données source. Les méthodes actuelles de connectivité réseau incluent les suivantes :
- Liste d'autorisation d'adresses IP : cette méthode consiste à configurer le serveur de base de données source pour accepter les connexions à partir de Datastream. Si vous sélectionnez cette méthode de connectivité réseau, configurez votre base de données source pour autoriser les connexions entrantes provenant des adresses IP publiques Datastream pour la région que vous avez spécifiée pour le profil de connexion.
- Tunnel SSH de transfert : cette méthode établit une connectivité sécurisée et chiffrée entre Datastream et la base de données source, à l'aide d'un tunnel SSH vers un serveur de tunnel ou vers le serveur de base de données. Si vous sélectionnez cette méthode de connectivité réseau, alors :
- Saisissez le nom d'hôte ou l'adresse IP, ainsi que le port du serveur hôte du tunnel.
- Saisissez le nom d'utilisateur du compte pour le serveur hôte du tunnel.
- Sélectionnez la méthode d'authentification pour le tunnel SSH. Si vous sélectionnez Mot de passe comme méthode, saisissez le mot de passe du compte de la VM hôte bastion. Si vous sélectionnez Paire de clés privée/publique comme méthode, fournissez une clé privée.
- Configurez votre hôte de tunnel pour autoriser les connexions entrantes provenant des adresses IP publiques de Datastream pour la région que vous avez spécifiée pour le profil de connexion.
Connectivité privée : cette méthode vous permet d'établir une connectivité sécurisée entre Datastream et la base de données source, en interne dans Google Cloud, ou avec des sources externes connectées via VPN ou Interconnect. Cette communication s'effectue via une interface Private Service Connect ou une connexion d'appairage de VPC.
Si vous sélectionnez cette méthode de connectivité réseau et que vous avez créé une configuration de connectivité privée, sélectionnez cette configuration dans la liste des configurations. Ce type de configuration contient des informations que Datastream utilise pour communiquer avec la base de données source sur un réseau privé.
Si vous n'avez pas créé de configuration de connectivité privée, créez-en une en cliquant sur CRÉER UNE CONFIGURATION DE CONNECTIVITÉ PRIVÉE au bas de la liste déroulante, puis suivez les mêmes étapes que dansCréer une configuration de connectivité privée.
Dans la section Définir la méthode de connectivité, cliquez sur CONTINUER. La section Tester le profil de connexion de la page Créer un profil Oracle est active.
Cliquez sur RUN TEST (EXÉCUTER LE TEST) pour vérifier que Datastream peut communiquer avec la source.
Si le test échoue, il indique quelle partie du processus a rencontré un problème. Pour connaître la procédure de dépannage, consultez la page Diagnostiquer les problèmes. Vous pouvez apporter les modifications nécessaires, puis effectuer un nouveau test sur la page Créer un profil Oracle.
Accédez à la partie du flux en question pour corriger le problème, puis effectuez un nouveau test.
Cliquez sur CRÉER.
Créer un profil de connexion pour une base de données MySQL
Accédez à la page Profils de connexion de la console Google Cloud .
Cliquez sur CRÉER UN PROFIL.
Sur la page Créer un profil de connexion, cliquez sur le type de profil MySQL.
Utilisez le tableau suivant pour renseigner les champs de la section Définir les paramètres de connexion de la page Créer un profil MySQL :
Champ Description Nom du profil de connexion Saisissez le nom à afficher du profil de connexion à la base de données MySQL source. Ce nom est utilisé dans la liste des profils de connexion, ainsi que lorsqu'un profil de connexion existant est sélectionné lors de la création d'un flux. ID du profil de connexion Datastream remplit automatiquement ce champ en fonction du nom du profil de connexion que vous saisissez. Vous pouvez conserver l'ID généré automatiquement ou le modifier. Région Sélectionnez la région dans laquelle le profil de connexion est stocké. Comme toutes les ressources, les profils de connexion sont enregistrés dans une région. Un flux ne peut utiliser que des profils de connexion stockés dans la même région que lui. La sélection de la région n'affecte pas la capacité de Datastream de se connecter à la source ou à la destination, mais peut affecter la disponibilité si la région subit un temps d'arrêt. Nom d'hôte ou adresse IP Saisissez un nom d'hôte ou une adresse IP que Datastream peut utiliser pour se connecter à la base de données MySQL source.
Si vous utilisez une connectivité privée pour communiquer avec la base de données source, spécifiez l'adresse IP privée (interne) de la base de données source.
Pour les autres méthodes de connectivité, telles que la liste d'autorisation d'adresses IP ou le transfert SSH, indiquez l'adresse IP publique.
Port Saisissez le numéro de port réservé à la base de données source (le port par défaut est généralement 3306). Username (Nom d'utilisateur) Saisissez le nom d'utilisateur du compte de la base de données source (par exemple,
root). Il s'agit de l'utilisateur Datastream que vous avez créé pour la base de données.Pour en savoir plus sur la création de cet utilisateur, consultez Configurer une base de données MySQL source.
Sélectionner le mot de passe de Secret Manager Sélectionnez cette option si vous souhaitez vous authentifier avec un secret plutôt que de saisir le mot de passe manuellement. Lorsque vous sélectionnez cette option, deux menus déroulants s'affichent : - Secret : vous pouvez sélectionner un secret dans la liste (si disponible), le saisir manuellement ou en créer un : Pour saisir un secret manuellement :
- Cliquez sur Saisir le secret manuellement. La boîte de dialogue Ajouter un secret via un ID de ressource s'affiche.
- Copiez et collez l'identifiant de ressource de votre secret depuis Secret Manager. L'ID de ressource du secret peut avoir le format suivant :
projects/PROJECT_NUMBER/secrets/SECRET_NAME(dernière version)projects/PROJECT_NUMBER/secrets/SECRET_NAME/versions/VERSION_NUMBER(version spécifique)- Cliquez sur Ajouter un secret.
- Cliquez sur Créer un secret. Le panneau latéral Détails du secret s'ouvre.
- Sous Nom, saisissez un nom pour le secret (par exemple,
my-secret). Un nom de secret peut contenir des lettres majuscules et minuscules, des chiffres, des traits d'union et des traits de soulignement. La longueur maximale autorisée pour un nom est de 255 caractères. Le nom que vous créez est ajouté à l'identifiant de la ressource de secret. - Facultatif : Si vous souhaitez également ajouter une version lors de la création du secret initial, saisissez une valeur pour le secret dans le champ Valeur du secret (par exemple,
abcd1234). La valeur du secret peut être indiquée dans n'importe quel format, mais elle ne doit pas dépasser 64 Kio. Vous pouvez également importer un fichier texte contenant la valeur du secret à l'aide de l'option Importer un fichier. - Cliquez sur le bouton Créer un secret.
- Version du secret : saisissez la version du secret que vous souhaitez utiliser :
- Lorsque vous fournissez l'identifiant de la ressource du secret, la case Utiliser la dernière version s'affiche. Vous pouvez la sélectionner pour utiliser la version la plus récente de votre ressource de secret.
- Vous pouvez également développer le menu déroulant Version du secret et sélectionner la version dans la liste, si elle est disponible.
- Si vous souhaitez utiliser une autre version du secret, procédez comme suit :
- Cliquez sur Ajouter une version.
- Dans le champ Valeur du secret, saisissez une valeur pour le secret. Vous pouvez également importer un fichier contenant la valeur du secret.
- Cliquez sur le bouton Ajouter une nouvelle version.
Saisir le mot de passe manuellement Vous pouvez également saisir manuellement le mot de passe du compte de la base de données source.
Vous pouvez également utiliser des libellés pour organiser vos ressources DataStream.
- Pour créer un libellé, cliquez sur AJOUTER UN LIBELLÉ, puis saisissez la paire clé-valeur du libellé.
- Pour supprimer le libellé, cliquez sur l'icône de corbeille à droite de la ligne correspondant au libellé.
Dans la section Définir les paramètres de connexion, cliquez sur CONTINUER. La page Sécuriser votre connexion à la source est active.
Dans le menu Type de chiffrement, sélectionnez l'une des options suivantes :
Type de chiffrement Description Aucun Datastream se connecte à la base de données source sans chiffrement. Serveur uniquement Lorsque Datastream se connecte à la base de données source, il authentifie la source et s'assure qu'elle se connecte à l'hôte correct de manière sécurisée. Cela empêche les attaques dites MITM.
Pour l'authentification serveur uniquement, la source n'authentifie pas Datastream. Pour utiliser l'authentification serveur uniquement, vous devez fournir le certificat X.509 de l'autorité de certification qui a signé le certificat du serveur, encodé au format PEM. Veillez à utiliser un seul certificat, car Datastream n'accepte pas les chaînes de certificats.
Serveur-client Lorsqu'il se connecte à la source, Datastream authentifie la source et celle-ci l'authentifie.
L'authentification serveur-client offre le niveau de sécurité le plus élevé. Toutefois, si vous ne souhaitez pas fournir le certificat client et la clé privée lors de la création du profil de connexion, vous pouvez toujours utiliser l'authentification serveur uniquement.
Pour utiliser l'authentification serveur-client, vous devez fournir les éléments suivants lors de la création du profil de connexion source :
- Le certificat de l'autorité de certification qui a signé le certificat du serveur de base de données source (le certificat CA).
- Certificat utilisé par l'instance pour s'authentifier auprès du serveur de base de données source (certificat client).
- Clé privée associée au certificat client (clé client).
Dans la section Sécurisez votre connexion à la source, cliquez sur CONTINUER. La section Définir une méthode de connectivité de la page Créer un profil MySQL est active.
Dans le menu déroulant Méthode de connectivité, sélectionnez une méthode de connectivité réseau. Cette méthode définit la manière dont Datastream se connecte à la base de données source. Les méthodes actuelles de connectivité réseau incluent les suivantes :
- Liste d'autorisation d'adresses IP : cette méthode consiste à configurer le serveur de base de données source pour accepter les connexions à partir de Datastream. Si vous sélectionnez cette méthode de connectivité réseau, configurez votre base de données source pour autoriser les connexions entrantes provenant des adresses IP publiques Datastream pour la région que vous avez spécifiée pour le profil de connexion.
- Tunnel SSH de transfert : cette méthode établit une connectivité sécurisée et chiffrée entre Datastream et la base de données source, à l'aide d'un tunnel SSH vers un serveur de tunnel ou vers le serveur de base de données. Si vous sélectionnez cette méthode de connectivité réseau, alors :
- Saisissez le nom d'hôte ou l'adresse IP, ainsi que le port du serveur hôte du tunnel.
- Saisissez le nom d'utilisateur du compte pour le serveur hôte du tunnel.
- Sélectionnez la méthode d'authentification pour le tunnel SSH. Si vous sélectionnez Mot de passe comme méthode, saisissez le mot de passe du compte de la VM hôte bastion. Si vous sélectionnez Paire de clés privée/publique comme méthode, fournissez une clé privée.
- Configurez votre hôte de tunnel pour autoriser les connexions entrantes provenant des adresses IP publiques de Datastream pour la région que vous avez spécifiée pour le profil de connexion.
Connectivité privée : cette méthode vous permet d'établir une connectivité sécurisée entre Datastream et la base de données source, en interne dans Google Cloud, ou avec des sources externes connectées via VPN ou Interconnect. Cette communication s'effectue via une interface Private Service Connect ou une connexion d'appairage de VPC.
Si vous sélectionnez cette méthode de connectivité réseau et que vous avez créé une configuration de connectivité privée, sélectionnez cette configuration dans la liste des configurations. Ce type de configuration contient des informations que Datastream utilise pour communiquer avec la base de données source sur un réseau privé.
Si vous n'avez pas créé de configuration de connectivité privée, créez-en une en cliquant sur CRÉER UNE CONFIGURATION DE CONNECTIVITÉ PRIVÉE au bas de la liste déroulante, puis suivez les mêmes étapes que dansCréer une configuration de connectivité privée.
Dans la section Définir la méthode de connectivité, cliquez sur CONTINUER. La section Tester le profil de connexion de la page Créer un profil MySQL est active.
Cliquez sur RUN TEST (EXÉCUTER LE TEST) pour vérifier que Datastream peut communiquer avec la source.
Si le test échoue, il indique quelle partie du processus a rencontré un problème. Pour connaître la procédure de dépannage, consultez la page Diagnostiquer les problèmes. Vous pouvez apporter les modifications nécessaires, puis tester à nouveau le profil de connexion.
Accédez à la partie du flux en question pour corriger le problème, puis effectuez un nouveau test.
Cliquez sur CRÉER.
Créer un profil de connexion pour une base de données PostgreSQL
Accédez à la page Profils de connexion de la console Google Cloud .
Cliquez sur CRÉER UN PROFIL.
Sur la page Créer un profil de connexion, cliquez sur le type de profil PostgreSQL.
Utilisez le tableau suivant pour renseigner les champs de la section Définir les paramètres de connexion de la page Créer un profil PostgreSQL :
Champ Description Nom du profil de connexion Saisissez le nom à afficher du profil de connexion à la base de données PostgreSQL source. Ce nom est utilisé dans la liste des profils de connexion, ainsi que lorsqu'un profil de connexion existant est sélectionné lors de la création d'un flux. ID du profil de connexion Datastream remplit automatiquement ce champ en fonction du nom du profil de connexion que vous saisissez. Vous pouvez conserver l'ID généré automatiquement ou le modifier. Région Sélectionnez la région dans laquelle le profil de connexion est stocké. Comme toutes les ressources, les profils de connexion sont enregistrés dans une région. Un flux ne peut utiliser que des profils de connexion stockés dans la même région que lui. La sélection de la région n'affecte pas la capacité de Datastream de se connecter à la source ou à la destination, mais peut affecter la disponibilité si la région subit un temps d'arrêt. Nom d'hôte ou adresse IP Saisissez un nom d'hôte ou une adresse IP que Datastream peut utiliser pour se connecter à la base de données PostgreSQL source.
Si vous utilisez une connectivité privée pour communiquer avec la base de données source, spécifiez l'adresse IP privée (interne) de la base de données source.
Pour les autres méthodes de connectivité, telles que la liste d'autorisation d'adresses IP ou le transfert SSH, indiquez l'adresse IP publique.
Port Saisissez le numéro de port réservé à la base de données source (le port par défaut pour PostgreSQL est généralement 5432). Nom d'utilisateur Saisissez le nom d'utilisateur du compte de la base de données source (par exemple,
root). Il s'agit de l'utilisateur Datastream que vous avez créé pour la base de données.Pour en savoir plus sur la création de cet utilisateur, consultez Configurer votre base de données PostgreSQL source.
Sélectionner le mot de passe de Secret Manager Sélectionnez cette option si vous souhaitez vous authentifier avec un secret plutôt que de saisir le mot de passe manuellement. Lorsque vous sélectionnez cette option, deux menus déroulants s'affichent : - Secret : vous pouvez sélectionner un secret dans la liste (si disponible), le saisir manuellement ou en créer un : Pour saisir un secret manuellement :
- Cliquez sur Saisir le secret manuellement. La boîte de dialogue Ajouter un secret via un ID de ressource s'affiche.
- Copiez et collez l'identifiant de ressource de votre secret depuis Secret Manager. L'ID de ressource du secret peut avoir le format suivant :
projects/PROJECT_NUMBER/secrets/SECRET_NAME(dernière version)projects/PROJECT_NUMBER/secrets/SECRET_NAME/versions/VERSION_NUMBER(version spécifique)- Cliquez sur le bouton Ajouter un secret.
- Cliquez sur Créer un secret. Le panneau latéral Détails du secret s'ouvre.
- Sous Nom, saisissez un nom pour le secret (par exemple,
my-secret). Un nom de secret peut contenir des lettres majuscules et minuscules, des chiffres, des traits d'union et des traits de soulignement. La longueur maximale autorisée pour un nom est de 255 caractères. Le nom que vous créez est ajouté à l'identifiant de la ressource de secret. - Facultatif : Si vous souhaitez également ajouter une version lors de la création du secret initial, saisissez une valeur pour le secret dans le champ Valeur du secret (par exemple,
abcd1234). La valeur du secret peut être indiquée dans n'importe quel format, mais elle ne doit pas dépasser 64 Kio. Vous pouvez également importer un fichier texte contenant la valeur du secret à l'aide de l'option Importer un fichier. - Cliquez sur le bouton Créer un secret.
- Version du secret : saisissez la version du secret que vous souhaitez utiliser :
- Lorsque vous fournissez l'identifiant de la ressource du secret, la case Utiliser la dernière version s'affiche. Vous pouvez la sélectionner pour utiliser la version la plus récente de votre ressource de secret.
- Vous pouvez également développer le menu déroulant Version du secret et sélectionner la version dans la liste, si elle est disponible.
- Si vous souhaitez utiliser une autre version du secret, procédez comme suit :
- Cliquez sur Ajouter une version.
- Dans le champ Valeur du secret, saisissez une valeur pour le secret. Vous pouvez également importer un fichier contenant la valeur du secret.
- Cliquez sur le bouton Ajouter une nouvelle version.
Saisir le mot de passe manuellement Vous pouvez également saisir manuellement le mot de passe du compte de la base de données source.
Base de données Saisissez le nom qui identifie l'instance de base de données. Pour les bases de données PostgreSQL, il s'agit généralement de
postgres.Vous pouvez également utiliser des libellés pour organiser vos ressources DataStream.
- Pour créer un libellé, cliquez sur AJOUTER UN LIBELLÉ, puis saisissez la paire clé-valeur du libellé.
- Pour supprimer le libellé, cliquez sur l'icône de corbeille à droite de la ligne correspondant au libellé.
Cliquez sur CONTINUER. La page Sécuriser votre connexion à la source est active.
Dans le menu Type de chiffrement, sélectionnez l'une des options suivantes :
Type de chiffrement Description Aucun Datastream se connecte à la base de données source sans chiffrement. Serveur uniquement Lorsque Datastream se connecte à la base de données source, il authentifie la source et s'assure qu'elle se connecte à l'hôte correct de manière sécurisée. Cela empêche les attaques dites MITM.
Pour l'authentification serveur uniquement, la source n'authentifie pas Datastream. Pour utiliser l'authentification serveur uniquement, vous devez fournir le certificat X.509 de l'autorité de certification qui a signé le certificat du serveur, encodé au format PEM. Veillez à utiliser un seul certificat, car Datastream n'accepte pas les chaînes de certificats.
Serveur-client Lorsqu'il se connecte à la source, Datastream authentifie la source et celle-ci l'authentifie.
L'authentification serveur-client offre le niveau de sécurité le plus élevé. Toutefois, si vous ne souhaitez pas fournir le certificat client et la clé privée lors de la création du profil de connexion, vous pouvez toujours utiliser l'authentification serveur uniquement.
Pour utiliser l'authentification serveur-client, vous devez fournir les éléments suivants lors de la création du profil de connexion source :
- Le certificat de l'autorité de certification qui a signé le certificat du serveur de base de données source (le certificat CA).
- Certificat utilisé par l'instance pour s'authentifier auprès du serveur de base de données source (certificat client).
- Clé privée associée au certificat client (clé client).
Cliquez sur CONTINUER. La section Définir la méthode de connectivité de la page Créer un profil PostgreSQL est active.
Dans le menu déroulant Méthode de connectivité, sélectionnez une méthode de connectivité réseau. Cette méthode définit la manière dont Datastream se connecte à la base de données source. Les méthodes actuelles de connectivité réseau incluent les suivantes :
- Liste d'autorisation d'adresses IP : cette méthode consiste à configurer le serveur de base de données source pour accepter les connexions à partir de Datastream. Si vous sélectionnez cette méthode de connectivité réseau, configurez votre base de données source pour autoriser les connexions entrantes provenant des adresses IP publiques Datastream pour la région que vous avez spécifiée pour le profil de connexion.
- Tunnel SSH de transfert : cette méthode établit une connectivité sécurisée et chiffrée entre Datastream et la base de données source, à l'aide d'un tunnel SSH vers un serveur de tunnel ou vers le serveur de base de données. Si vous sélectionnez cette méthode de connectivité réseau, alors :
- Saisissez le nom d'hôte ou l'adresse IP, ainsi que le port du serveur hôte du tunnel.
- Saisissez le nom d'utilisateur du compte pour le serveur hôte du tunnel.
- Sélectionnez la méthode d'authentification pour le tunnel SSH. Si vous sélectionnez Mot de passe comme méthode, saisissez le mot de passe du compte de la VM hôte bastion. Si vous sélectionnez Paire de clés privée/publique comme méthode, fournissez une clé privée.
- Configurez votre hôte de tunnel pour autoriser les connexions entrantes provenant des adresses IP publiques de Datastream pour la région que vous avez spécifiée pour le profil de connexion.
Connectivité privée : cette méthode vous permet d'établir une connectivité sécurisée entre Datastream et la base de données source, en interne dans Google Cloud, ou avec des sources externes connectées via VPN ou Interconnect. Cette communication s'effectue via une interface Private Service Connect ou une connexion d'appairage de VPC.
Si vous sélectionnez cette méthode de connectivité réseau et que vous avez créé une configuration de connectivité privée, sélectionnez cette configuration dans la liste des configurations. Ce type de configuration contient des informations que Datastream utilise pour communiquer avec la base de données source sur un réseau privé.
Si vous n'avez pas créé de configuration de connectivité privée, créez-en une en cliquant sur CRÉER UNE CONFIGURATION DE CONNECTIVITÉ PRIVÉE au bas de la liste déroulante, puis suivez les mêmes étapes que dansCréer une configuration de connectivité privée.
Dans la section Définir la méthode de connectivité, cliquez sur CONTINUER. La section Tester le profil de connexion de la page Créer un profil PostgreSQL est active.
Cliquez sur RUN TEST (EXÉCUTER LE TEST) pour vérifier que Datastream peut communiquer avec la source.
Si le test échoue, il indique quelle partie du processus a rencontré un problème. Pour connaître la procédure de dépannage, consultez la page Diagnostiquer les problèmes. Vous pouvez apporter les modifications nécessaires, puis tester à nouveau le profil de connexion.
Accédez à la partie du flux en question pour corriger le problème, puis effectuez un nouveau test.
Cliquez sur CRÉER.
Créer un profil de connexion pour une base de données SQL Server
Accédez à la page Profils de connexion de la console Google Cloud .
Cliquez sur CRÉER UN PROFIL.
Sur la page Créer un profil de connexion, cliquez sur le type de profil SQL Server.
Utilisez le tableau suivant pour renseigner les champs de la section Définir les paramètres de connexion de la page Créer un profil SQL Server :
Champ Description Nom du profil de connexion Saisissez le nom à afficher du profil de connexion à la base de données SQL Server source. Ce nom est utilisé dans la liste des profils de connexion, ainsi que lorsqu'un profil de connexion existant est sélectionné lors de la création d'un flux. ID du profil de connexion Datastream remplit automatiquement ce champ en fonction du nom du profil de connexion que vous saisissez. Vous pouvez conserver l'ID généré automatiquement ou le modifier. Région Sélectionnez la région dans laquelle le profil de connexion est stocké. Comme toutes les ressources, les profils de connexion sont enregistrés dans une région. Un flux ne peut utiliser que des profils de connexion stockés dans la même région que lui. La sélection de la région n'affecte pas la capacité de Datastream de se connecter à la source ou à la destination, mais peut affecter la disponibilité si la région subit un temps d'arrêt. Nom d'hôte ou adresse IP Saisissez un nom d'hôte ou une adresse IP que Datastream peut utiliser pour se connecter à la base de données SQL Server source.
Si vous utilisez une connectivité privée pour communiquer avec la base de données source, spécifiez l'adresse IP privée (interne) de la base de données source.
Pour l'ajout d'adresses IP à la liste d'autorisation, indiquez l'adresse IP publique.
Port Saisissez le numéro de port réservé à la base de données source (le port par défaut est généralement 1433). Nom d'utilisateur Saisissez le nom d'utilisateur du compte de la base de données source (par exemple,
root). Il s'agit de l'utilisateur Datastream que vous avez créé pour la base de données.Pour en savoir plus sur la création de cet utilisateur, consultez Configurer votre base de données SQL Server source.
Sélectionner le mot de passe de Secret Manager Sélectionnez cette option si vous souhaitez vous authentifier avec un secret plutôt que de saisir le mot de passe manuellement. Lorsque vous sélectionnez cette option, deux menus déroulants s'affichent : - Secret : vous pouvez sélectionner un secret dans la liste (si disponible), le saisir manuellement ou en créer un : Pour saisir un secret manuellement :
- Cliquez sur Saisir le secret manuellement. La boîte de dialogue Ajouter un secret via un ID de ressource s'affiche.
- Copiez et collez l'identifiant de ressource de votre secret depuis Secret Manager. L'ID de ressource du secret peut avoir le format suivant :
projects/PROJECT_NUMBER/secrets/SECRET_NAME(dernière version)projects/PROJECT_NUMBER/secrets/SECRET_NAME/versions/VERSION_NUMBER(version spécifique)- Cliquez sur le bouton Ajouter un secret.
- Cliquez sur Créer un secret. Le panneau latéral Détails du secret s'ouvre.
- Sous Nom, saisissez un nom pour le secret (par exemple,
my-secret). Un nom de secret peut contenir des lettres majuscules et minuscules, des chiffres, des traits d'union et des traits de soulignement. La longueur maximale autorisée pour un nom est de 255 caractères. Le nom que vous créez est ajouté à l'identifiant de la ressource de secret. - Facultatif : Si vous souhaitez également ajouter une version lors de la création du secret initial, saisissez une valeur pour le secret dans le champ Valeur du secret (par exemple,
abcd1234). La valeur du secret peut être indiquée dans n'importe quel format, mais elle ne doit pas dépasser 64 Kio. Vous pouvez également importer un fichier texte contenant la valeur du secret à l'aide de l'option Importer un fichier. - Cliquez sur le bouton Créer un secret.
- Version du secret : saisissez la version du secret que vous souhaitez utiliser :
- Lorsque vous fournissez l'identifiant de la ressource du secret, la case Utiliser la dernière version s'affiche. Vous pouvez la sélectionner pour utiliser la version la plus récente de votre ressource de secret.
- Vous pouvez également développer le menu déroulant Version du secret et sélectionner la version dans la liste, si elle est disponible.
- Si vous souhaitez utiliser une autre version du secret, procédez comme suit :
- Cliquez sur Ajouter une version.
- Dans le champ Valeur du secret, saisissez une valeur pour le secret. Vous pouvez également importer un fichier contenant la valeur du secret.
- Cliquez sur le bouton Ajouter une nouvelle version.
Saisir le mot de passe manuellement Vous pouvez également saisir manuellement le mot de passe du compte de la base de données source.
Base de données Saisissez le nom qui identifie l'instance de base de données.
Vous pouvez également utiliser des libellés pour organiser vos ressources DataStream.
- Pour créer un libellé, cliquez sur AJOUTER UN LIBELLÉ, puis saisissez la paire clé-valeur du libellé.
- Pour supprimer le libellé, cliquez sur l'icône de corbeille à droite de la ligne correspondant au libellé.
Cliquez sur Continuer.
Dans la section Définir la méthode de connectivité, sélectionnez une méthode de connectivité réseau dans le menu déroulant Méthode de connectivité. Cette méthode définit la manière dont Datastream se connecte à la base de données source. Les méthodes de connectivité réseau incluent les suivantes :
- Liste d'autorisation d'adresses IP : cette méthode consiste à configurer le serveur de base de données source pour accepter les connexions à partir de Datastream. Si vous sélectionnez cette méthode de connectivité réseau, configurez votre base de données source pour autoriser les connexions entrantes provenant des adresses IP publiques Datastream pour la région que vous avez spécifiée pour le profil de connexion.
- Tunnel SSH de transfert : cette méthode crée une connexion sécurisée et chiffrée entre la base de données source et Datastream. Pour configurer cette méthode de connectivité, vous avez besoin d'un serveur SSH ayant accès à la base de données source. Si vous sélectionnez cette méthode de connectivité réseau, alors :
- Saisissez le nom d'hôte ou l'adresse IP, ainsi que le port du serveur hôte du tunnel.
- Saisissez le nom d'utilisateur du compte pour le serveur hôte du tunnel.
- Sélectionnez la méthode d'authentification pour le tunnel SSH. Si vous sélectionnez Paire de clés privée/publique comme méthode, fournissez une clé privée. Si vous sélectionnez Mot de passe comme méthode, saisissez le mot de passe du compte de la VM hôte bastion.
- Vous devrez peut-être également ajouter les adresses IP externes Datastream à la liste d'autorisation sur le serveur du tunnel SSH.
Connectivité privée : cette méthode vous permet d'établir une connectivité sécurisée entre Datastream et la base de données source, en interne dans Google Cloud, ou avec des sources externes connectées via VPN ou Interconnect. Cette communication s'effectue via une interface Private Service Connect ou une connexion d'appairage de VPC.
Si vous sélectionnez cette méthode de connectivité réseau et que vous avez créé une configuration de connectivité privée, sélectionnez cette configuration dans la liste des configurations. Ce type de configuration contient des informations que Datastream utilise pour communiquer avec la base de données source sur un réseau privé.
Si vous n'avez pas créé de configuration de connectivité privée, créez-en une en cliquant sur CRÉER UNE CONFIGURATION DE CONNECTIVITÉ PRIVÉE au bas de la liste déroulante, puis suivez les mêmes étapes que dansCréer une configuration de connectivité privée.
Cliquez sur CONTINUER. La section Tester le profil de connexion de la page Créer un profil SQL Server est active.
Cliquez sur RUN TEST (EXÉCUTER LE TEST) pour vérifier que Datastream peut communiquer avec la source.
Si le test échoue, il indique quelle partie du processus a rencontré un problème. Pour connaître la procédure de dépannage, consultez la page Diagnostiquer les problèmes. Vous pouvez apporter les modifications nécessaires, puis tester à nouveau le profil de connexion.
Accédez à la partie du flux en question pour corriger le problème, puis effectuez un nouveau test.
Cliquez sur CRÉER.
Créer un profil de connexion pour une organisation Salesforce
Accédez à la page Profils de connexion de la console Google Cloud .
Cliquez sur CRÉER UN PROFIL.
Sur la page Créer un profil de connexion, cliquez sur le type de profil Salesforce.
Utilisez le tableau suivant pour renseigner les champs de la section Définir les paramètres de connexion de la page Créer un profil Salesforce :
Champ Description Nom du profil de connexion Saisissez le nom à afficher du profil de connexion à l'organisation Salesforce source. Ce nom est utilisé dans la liste des profils de connexion, ainsi que lorsqu'un profil de connexion existant est sélectionné lors de la création d'un flux. ID du profil de connexion Datastream remplit automatiquement ce champ en fonction du nom du profil de connexion que vous saisissez. Vous pouvez conserver l'ID généré automatiquement ou le modifier. Région Sélectionnez la région dans laquelle le profil de connexion est stocké. Comme toutes les ressources, les profils de connexion sont enregistrés dans une région. Un flux ne peut utiliser que des profils de connexion stockés dans la même région que lui. La sélection de la région n'affecte pas la capacité de Datastream de se connecter à la source ou à la destination, mais peut affecter la disponibilité si la région subit un temps d'arrêt. Dans la section Détails de connexion, saisissez l'adresse URL de votre domaine Salesforce. Pour trouver l'URL de votre domaine, accédez à Salesforce, puis cliquez sur Configuration > Paramètres de l'entreprise > Mon domaine. L'URL se trouve sous My domain details (Détails de mon domaine). Il se présente généralement au format suivant :
domain-name.my.salesforce.com.Sous Méthode d'authentification, sélectionnez votre méthode d'authentification :
Authentification par identifiants client OAuth 2.0 : si vous sélectionnez cette option, vous devez indiquer votre ID client et votre code secret du client. Pour le code secret du client, vous pouvez fournir l'ID de ressource et la version du secret à partir de Secret Manager (par exemple,
projects/my-project/locations/us-central1/secrets/salesforce-secret/versions/1) ou saisir la valeur brute du secret.Pour savoir comment obtenir l'ID client et le code secret du client, consultez Configurer une organisation Salesforce source.
Authentification par nom d'utilisateur/mot de passe : si vous sélectionnez cette option, vous devez saisir le nom d'utilisateur et le mot de passe de votre compte Salesforce.
- Pour le nom d'utilisateur, saisissez le nom que vous utilisez pour vous connecter à Salesforce. Si vous êtes déjà connecté à votre organisation Salesforce, vous pouvez trouver votre nom d'utilisateur en ouvrant la page des paramètres de votre compte et en cliquant sur Informations personnelles. Le nom se trouve sous Nom d'utilisateur.
Pour le mot de passe, vous pouvez fournir l'ID et la version de la ressource du secret à partir de Secret Manager, par exemple
projects/my-project/locations/us-central1/secrets/salesforce-secret/versions/1, ou fournir la valeur brute de votre mot de passe.Dans la section Jeton de sécurité, indiquez l'ID de ressource et la version de votre secret de jeton à partir de Secret Manager, par exemple
projects/my-project/locations/us-central1/secrets/salesforce-secret/versions/1, ou saisissez la valeur brute du jeton de sécurité, par exempleC08120F510542FFB1C3640F57AF19E2D5D700556A25F7D665C3B428407709D8C.
Vous pouvez également utiliser des libellés pour organiser vos ressources DataStream.
- Pour créer un libellé, cliquez sur AJOUTER UN LIBELLÉ, puis saisissez la paire clé-valeur du libellé.
- Pour supprimer le libellé, cliquez sur l'icône de corbeille à droite de la ligne correspondant au libellé.
Cliquez sur Continuer.
Dans la section Vérifier la méthode de connectivité, examinez les adresses IP régionales Datastream listées et assurez-vous d'avoir configuré votre organisation Salesforce pour qu'elle accepte les connexions entrantes provenant de ces adresses. Pour en savoir plus sur la configuration de votre instance Salesforce, consultez Configurer une organisation Salesforce.
Cliquez sur CONTINUER. La section Tester le profil de connexion de la page Créer un profil Salesforce est active.
Cliquez sur RUN TEST (EXÉCUTER LE TEST) pour vérifier que Datastream peut communiquer avec la source.
Si le test échoue, il indique quelle partie du processus a rencontré un problème. Pour connaître la procédure de dépannage, consultez la page Diagnostiquer les problèmes. Vous pouvez apporter les modifications nécessaires, puis tester à nouveau le profil de connexion.
Accédez à la partie du flux en question pour corriger le problème, puis effectuez un nouveau test.
Cliquez sur CRÉER.
Créer un profil de connexion pour un environnement Dataverse
Accédez à la page Profils de connexion de la console Google Cloud .
Cliquez sur Créer un profil.
Sur la page Créer un profil de connexion, cliquez sur le type de profil Dataverse.
Utilisez le tableau suivant pour renseigner les champs de la section Définir les paramètres de connexion de la page Créer un profil Dataverse :
Champ Description Nom du profil de connexion Saisissez le nom à afficher du profil de connexion à la source Dataverse. Ce nom est utilisé dans la liste des profils de connexion, ainsi que lorsqu'un profil de connexion existant est sélectionné lors de la création d'un flux. ID du profil de connexion Datastream remplit automatiquement ce champ en fonction du nom du profil de connexion que vous saisissez. Vous pouvez conserver l'ID généré automatiquement ou le modifier. Région Sélectionnez la région dans laquelle le profil de connexion est stocké. Comme toutes les ressources, les profils de connexion sont enregistrés dans une région. Un flux ne peut utiliser que des profils de connexion stockés dans la même région que lui. La sélection de la région n'affecte pas la capacité de Datastream de se connecter à la source ou à la destination, mais peut affecter la disponibilité si la région subit un temps d'arrêt. URL de l'environnement Saisissez l'URL de votre environnement Dataverse, par exemple myorg.crm4.dynamics.com.ID du locataire Saisissez l'identifiant du locataire Azure Active Directory associé à votre environnement Dataverse. Cela permet d'identifier l'instance Azure AD utilisée pour l'authentification. ID client Saisissez l'identifiant client de l'application Azure AD enregistrée pour se connecter à Dataverse. Cette application doit être configurée avec les autorisations d'API nécessaires. Code secret du client Saisissez la clé ou la valeur secrète générée pour l'application Azure AD. Ce secret est utilisé, avec l'ID client, pour authentifier l'application et établir la connexion. Dans la section Définir la méthode de connectivité, cliquez sur Continuer. La section Tester le profil de connexion de la page Créer un profil Dataverse est active.
Cliquez sur Exécuter le test pour vérifier que Datastream peut communiquer avec la source.
Si le test échoue, il indique quelle partie du processus a rencontré un problème. Pour connaître la procédure de dépannage, consultez la page Diagnostiquer les problèmes. Vous pouvez apporter les modifications nécessaires, puis effectuer un nouveau test sur la page Créer un profil Dataverse.
Accédez à la partie du flux en question pour corriger le problème, puis effectuez un nouveau test.
Cliquez sur CRÉER.
Créer un profil de connexion pour une instance Salesforce Marketing Cloud
Accédez à la page Profils de connexion de la console Google Cloud .
Cliquez sur Créer un profil.
Sur la page Créer un profil de connexion, cliquez sur le type de profil Salesforce Marketing Cloud.
Utilisez le tableau suivant pour renseigner les champs de la section Définir les paramètres de connexion de la page Créer un profil Salesforce Marketing Cloud :
Champ Description Nom du profil de connexion Saisissez le nom à afficher du profil de connexion à l'instance Salesforce Marketing Cloud source. Ce nom est utilisé dans la liste des profils de connexion, ainsi que lorsqu'un profil de connexion existant est sélectionné lors de la création d'un flux. ID du profil de connexion Datastream remplit automatiquement ce champ en fonction du nom du profil de connexion que vous saisissez. Vous pouvez conserver l'ID généré automatiquement ou le modifier. Région Sélectionnez la région dans laquelle le profil de connexion est stocké. Comme toutes les ressources, les profils de connexion sont enregistrés dans une région. Un flux ne peut utiliser que des profils de connexion stockés dans la même région que lui. La sélection de la région n'affecte pas la capacité de Datastream de se connecter à la source ou à la destination, mais peut affecter la disponibilité si la région subit un temps d'arrêt. Sous-domaine Saisissez le sous-domaine de votre instance Salesforce Marketing Cloud. Pour savoir comment obtenir le nom du sous-domaine, consultez Configurer une instance Salesforce Marketing Cloud. ID client Saisissez l'ID client de votre instance Salesforce Marketing Cloud. Pour en savoir plus sur l'obtention de l'identifiant client, consultez Configurer une instance Salesforce Marketing Cloud. Code secret du client Indiquez l'ID et la version de la ressource de secret depuis Secret Manager, ou saisissez la valeur brute du code secret du client depuis votre instance Salesforce Marketing Cloud. Vous pouvez également utiliser des libellés pour organiser vos ressources DataStream.
- Pour créer un libellé, cliquez sur AJOUTER UN LIBELLÉ, puis saisissez la paire clé-valeur du libellé.
- Pour supprimer le libellé, cliquez sur l'icône de corbeille à droite de la ligne correspondant au libellé.
Cliquez sur CONTINUER. La section Tester le profil de connexion de la page Créer un profil Salesforce Marketing Cloud est active.
Cliquez sur RUN TEST (EXÉCUTER LE TEST) pour vérifier que Datastream peut communiquer avec la source.
Si le test échoue, il indique quelle partie du processus a rencontré un problème. Pour connaître la procédure de dépannage, consultez la page Diagnostiquer les problèmes. Vous pouvez apporter les modifications nécessaires, puis tester à nouveau le profil de connexion.
Accédez à la partie du flux en question pour corriger le problème, puis effectuez un nouveau test.
Cliquez sur CRÉER.
Créer un profil de connexion pour une instance ServiceNow
Accédez à la page Profils de connexion de la console Google Cloud .
Cliquez sur CRÉER UN PROFIL.
Sur la page Créer un profil de connexion, cliquez sur le type de profil ServiceNow.
Utilisez le tableau suivant pour renseigner les champs de la section Définir les paramètres de connexion de la page Créer un profil ServiceNow :
Champ Description Nom du profil de connexion Saisissez le nom à afficher du profil de connexion à l'instance ServiceNow source. Datastream l'utilise dans la liste des profils de connexion et lorsque vous sélectionnez un profil de connexion existant lors de la création d'un flux. ID du profil de connexion Datastream remplit automatiquement ce champ en fonction du nom du profil de connexion que vous saisissez. Vous pouvez conserver l'ID généré automatiquement ou le modifier. Région Sélectionnez la région dans laquelle vous souhaitez stocker le profil de connexion. Comme toutes les ressources, les profils de connexion sont enregistrés dans une région. Un flux ne peut utiliser que des profils de connexion stockés dans la même région que lui. Instance Saisissez l'URL de votre instance ServiceNow. Il se présente généralement au format suivant : company.service-now.com.Méthode de connexion Sélectionnez votre méthode d'authentification : - Identifiants de l'application connectée : si vous sélectionnez cette option, vous devez remplir le champ ID client et la section Code secret du client. Pour le code secret du client, vous pouvez fournir l'ID de ressource et la version du secret depuis Secret Manager, ou saisir la valeur brute du secret.
- Identifiants utilisateur : si vous sélectionnez cette option, vous devez saisir le nom d'utilisateur et le mot de passe de votre compte ServiceNow. Pour le mot de passe, vous pouvez fournir l'ID et la version de la ressource de secret de Secret Manager, ou fournir la valeur brute du mot de passe que vous avez créé lorsque vous avez configuré votre utilisateur d'intégration dans ServiceNow. Pour en savoir plus, consultez Configurer un utilisateur d'intégration.
Vous pouvez également utiliser des libellés pour organiser vos ressources DataStream.
- Pour créer un libellé, cliquez sur AJOUTER UN LIBELLÉ, puis saisissez la paire clé-valeur du libellé.
- Pour supprimer le libellé, cliquez sur l'icône de corbeille à droite de la ligne correspondant au libellé.
Cliquez sur CONTINUER.
Dans la section Vérifier la méthode de connectivité, examinez les adresses IP régionales Datastream listées et assurez-vous d'avoir configuré votre instance ServiceNow pour qu'elle accepte les connexions entrantes provenant de ces adresses. Pour en savoir plus sur la configuration de votre instance ServiceNow, consultez Configurer une instance ServiceNow.
Cliquez sur CONTINUER. La section Tester le profil de connexion de la page Créer un profil ServiceNow est active.
Cliquez sur RUN TEST (EXÉCUTER LE TEST) pour vérifier que Datastream peut communiquer avec la source.
Cliquez sur CRÉER.
Créer un profil de connexion pour une base de données MongoDB
Accédez à la page Profils de connexion de la console Google Cloud .
Cliquez sur CRÉER UN PROFIL.
Sur la page Créer un profil de connexion, cliquez sur le type de profil MongoDB.
Dans la section Définir les paramètres de connexion, spécifiez les informations suivantes :
Champ Description Nom du profil de connexion Saisissez le nom à afficher du profil de connexion à la base de données MongoDB source. Ce nom est utilisé dans la liste des profils de connexion, ainsi que lorsqu'un profil de connexion existant est sélectionné lors de la création d'un flux. ID du profil de connexion Datastream remplit automatiquement ce champ en fonction du nom du profil de connexion que vous saisissez. Vous pouvez conserver l'ID généré automatiquement ou le modifier. Région Sélectionnez la région dans laquelle le profil de connexion est stocké. Comme toutes les ressources, les profils de connexion sont enregistrés dans une région. Un flux ne peut utiliser que des profils de connexion stockés dans la même région que lui. La sélection de la région n'affecte pas la capacité de Datastream de se connecter à la source ou à la destination, mais peut affecter la disponibilité si la région subit un temps d'arrêt. Format de la chaîne de connexion Spécifiez le format que vous souhaitez utiliser pour vous connecter à votre source MongoDB :
- Format de connexion SRV : chaîne de connexion avec un nom d'hôte correspondant à un enregistrement SRV de service de nom de domaine (DNS). Pour en savoir plus, consultez la documentation MongoDB.
- Format de chaîne de connexion standard : format standard de l'URI de connexion MongoDB utilisé pour se connecter à un déploiement autonome, un ensemble d'instances répliquées ou un cluster segmenté MongoDB autohébergé. Pour en savoir plus, consultez la documentation MongoDB. Lorsque vous sélectionnez cette option, vous devez ensuite sélectionner l'une des topologies MongoDB compatibles :
- Cluster segmenté : un cluster segmenté MongoDB se compose de segments, de mongos et de serveurs de configuration. MongoDB partitionne les données au niveau de la collection, en distribuant les données de la collection entre les segments du cluster.
- Ensemble d'instances répliquées : un ensemble d'instances répliquées dans MongoDB est un groupe de processus
mongodqui gèrent le même ensemble de données. Les ensembles d'instances répliquées assurent la redondance et la haute disponibilité, et constituent la base de tous les déploiements de production. Lorsque vous sélectionnez cette option, vous devez fournir un nom d'ensemble d'instances répliquées.
Nom d'hôte Saisissez un nom d'hôte que Datastream peut utiliser pour se connecter à la base de données MongoDB source. Si vous utilisez le format de chaîne de connexion standard, vous pouvez ajouter les noms d'hôte de toutes les machines de l'ensemble d'instances répliquées.
Si vous utilisez une connectivité privée pour communiquer avec la base de données source, spécifiez l'adresse IP privée (interne) de la base de données source.
Pour les autres méthodes de connectivité, telles que la liste d'autorisation d'adresses IP, indiquez l'adresse IP publique.
Port Pour le format de chaîne de connexion standard uniquement. Saisissez le numéro de port réservé à la base de données source (le port par défaut pour MongoDB est généralement 27017). Vous pouvez ajouter les ports de toutes les machines de l'ensemble d'instances dupliquées lorsque vous utilisez le format de connexion standard. Nom d'utilisateur Saisissez le nom d'utilisateur du compte de la base de données source (par exemple, ROOT). Il s'agit de l'utilisateur Datastream que vous avez créé pour la base de données.Pour en savoir plus sur la création de cet utilisateur, consultez Configurer votre base de données MongoDB source.
Sélectionner le mot de passe dans Secret Manager Sélectionnez cette option si vous souhaitez vous authentifier avec un secret plutôt que de saisir le mot de passe manuellement. Lorsque vous sélectionnez cette option, deux menus déroulants s'affichent : - Secret : vous pouvez sélectionner un secret dans la liste (si disponible), le saisir manuellement ou en créer un : Pour saisir un secret manuellement :
- Cliquez sur Saisir le secret manuellement. La boîte de dialogue Ajouter un secret via un ID de ressource s'affiche.
- Copiez et collez l'identifiant de ressource de votre secret depuis Secret Manager. L'ID de ressource du secret peut avoir le format suivant :
projects/PROJECT_NUMBER/secrets/SECRET_NAME(dernière version)projects/PROJECT_NUMBER/secrets/SECRET_NAME/versions/VERSION_NUMBER(version spécifique)- Cliquez sur le bouton Ajouter un secret.
- Cliquez sur Créer un secret. Le panneau latéral Détails du secret s'ouvre.
- Sous Nom, saisissez un nom pour le secret (par exemple,
my-secret). Un nom de secret peut contenir des lettres majuscules et minuscules, des chiffres, des traits d'union et des traits de soulignement. La longueur maximale autorisée pour un nom est de 255 caractères. Le nom que vous créez est ajouté à l'identifiant de la ressource de secret. - Facultatif : Si vous souhaitez également ajouter une version lors de la création du secret initial, saisissez une valeur pour le secret dans le champ Valeur du secret (par exemple,
abcd1234). La valeur du secret peut être indiquée dans n'importe quel format, mais elle ne doit pas dépasser 64 Kio. Vous pouvez également importer un fichier texte contenant la valeur du secret à l'aide de l'option Importer un fichier. - Cliquez sur le bouton Créer un secret.
- Version du secret : saisissez la version du secret que vous souhaitez utiliser :
- Lorsque vous fournissez l'identifiant de la ressource du secret, la case Utiliser la dernière version s'affiche. Vous pouvez la sélectionner pour utiliser la version la plus récente de votre ressource de secret.
- Vous pouvez également développer le menu déroulant Version du secret et sélectionner la version dans la liste, si elle est disponible.
- Si vous souhaitez utiliser une autre version du secret, procédez comme suit :
- Cliquez sur Ajouter une version.
- Dans le champ Valeur du secret, saisissez une valeur pour le secret. Vous pouvez également importer un fichier contenant la valeur du secret.
- Cliquez sur le bouton Ajouter une nouvelle version.
Saisir le mot de passe manuellement Vous pouvez également saisir manuellement le mot de passe du compte de la base de données source.
Vous pouvez également utiliser des libellés pour organiser vos ressources DataStream.
- Pour créer un libellé, cliquez sur AJOUTER UN LIBELLÉ, puis saisissez la paire clé-valeur du libellé.
- Pour supprimer le libellé, cliquez sur l'icône de corbeille à droite de la ligne correspondant au libellé.
Cliquez sur Continuer.
Dans le menu Type de chiffrement, sélectionnez l'une des options suivantes :
L'authentification serveur-client offre le niveau de sécurité le plus élevé. Toutefois, si vous ne souhaitez pas fournir le certificat client et la clé privée lors de la création du profil de connexion, vous pouvez toujours utiliser l'authentification serveur uniquement.
Pour utiliser l'authentification serveur-client, vous devez fournir les éléments suivants lors de la création du profil de connexion source :
- Le certificat de l'autorité de certification qui a signé le certificat du serveur de base de données source (le certificat CA).
- Certificat utilisé par l'instance pour s'authentifier auprès du serveur de base de données source (certificat client).
- Clé privée associée au certificat client (clé client).
Type de chiffrement Description Aucun Datastream se connecte à la base de données source sans chiffrement. Serveur uniquement Lorsque Datastream se connecte à la base de données source, il authentifie la source et s'assure qu'elle se connecte à l'hôte correct de manière sécurisée. Cela empêche les attaques dites MITM.
Pour l'authentification serveur uniquement, la source n'authentifie pas Datastream. Pour utiliser l'authentification serveur uniquement, vous devez fournir le certificat X.509 de l'autorité de certification qui a signé le certificat du serveur, encodé au format PEM. Veillez à utiliser un seul certificat, car Datastream n'accepte pas les chaînes de certificats.
Serveur-client Lorsqu'il se connecte à la source, Datastream authentifie la source et celle-ci l'authentifie.
Dans la section Définir la méthode de connectivité, sélectionnez une méthode de connectivité réseau dans le menu déroulant Méthode de connectivité. Cette méthode définit la manière dont Datastream se connecte à la base de données source. Les méthodes de connectivité réseau incluent les suivantes :
- Liste d'autorisation d'adresses IP : cette méthode consiste à configurer le serveur de base de données source pour accepter les connexions à partir de Datastream. Si vous sélectionnez cette méthode de connectivité réseau, configurez votre base de données source pour autoriser les connexions entrantes provenant des adresses IP publiques Datastream pour la région que vous avez spécifiée pour le profil de connexion.
- Tunnel SSH de transfert : cette méthode crée une connexion sécurisée et chiffrée entre la base de données source et Datastream. Pour configurer cette méthode de connectivité, vous avez besoin d'un serveur SSH ayant accès à la base de données source. Si vous sélectionnez cette méthode de connectivité réseau, alors :
- Saisissez le nom d'hôte ou l'adresse IP du serveur SSH, ainsi que le port du serveur hôte du tunnel.
- Saisissez le nom d'utilisateur du compte pour le serveur hôte du tunnel.
- Sélectionnez la méthode d'authentification pour le tunnel SSH. Si vous sélectionnez Paire de clés privée/publique comme méthode, fournissez une clé privée. Si vous sélectionnez Mot de passe comme méthode, saisissez le mot de passe du compte de la VM hôte bastion.
- Vous devrez peut-être également ajouter les adresses IP externes Datastream à la liste d'autorisation sur le serveur du tunnel SSH.
Connectivité privée : cette méthode vous permet d'établir une connectivité sécurisée entre Datastream et la base de données source, en interne dans Google Cloud, ou avec des sources externes connectées via VPN ou Interconnect. Cette communication s'effectue via une interface Private Service Connect ou une connexion d'appairage de VPC.
Si vous sélectionnez cette méthode de connectivité réseau et que vous avez créé une configuration de connectivité privée, sélectionnez cette configuration dans la liste des configurations. Ce type de configuration contient des informations que Datastream utilise pour communiquer avec la base de données source sur un réseau privé.
Si vous n'avez pas créé de configuration de connectivité privée, créez-en une en cliquant sur CRÉER UNE CONFIGURATION DE CONNECTIVITÉ PRIVÉE au bas de la liste déroulante, puis suivez les mêmes étapes que dansCréer une configuration de connectivité privée.
Cliquez sur CONTINUER. La section Tester le profil de connexion de la page Créer un profil MongoDB est active.
Cliquez sur RUN TEST (EXÉCUTER LE TEST) pour vérifier que Datastream peut communiquer avec la source.
Si le test échoue, il indique quelle partie du processus a rencontré un problème. Pour connaître la procédure de dépannage, consultez la page Diagnostiquer les problèmes. Vous pouvez apporter les modifications nécessaires, puis tester à nouveau le profil de connexion.
Accédez à la partie du flux en question pour corriger le problème, puis effectuez un nouveau test.
Cliquez sur CRÉER.
Créer un profil de connexion pour une base de données Spanner
Accédez à la page Profils de connexion de la console Google Cloud .
Cliquez sur CRÉER UN PROFIL.
Sur la page Créer un profil de connexion, cliquez sur le type de profil Spanner.
Utilisez le tableau suivant pour renseigner les champs de la section Définir les paramètres de connexion de la page Créer un profil Spanner :
Champ Description Nom du profil de connexion Saisissez le nom à afficher du profil de connexion à la base de données Spanner source. ID du profil de connexion Datastream remplit automatiquement ce champ en fonction du nom du profil de connexion que vous saisissez. Région Sélectionnez la région dans laquelle le profil de connexion est stocké. Base de données Saisissez le chemin d'accès complet à la base de données, y compris les informations sur le projet, l'instance et la base de données. Il doit respecter le format suivant : projects/PROJECT_ID/instances/INSTANCE_ID/databases/DATABASE_ID.Vous pouvez également utiliser des libellés pour organiser vos ressources DataStream.
- Pour créer un libellé, cliquez sur AJOUTER UN LIBELLÉ, puis saisissez la paire clé-valeur du libellé.
- Pour supprimer le libellé, cliquez sur l'icône de corbeille à droite de la ligne correspondant au libellé.
Cliquez sur CONTINUER. La section Tester le profil de connexion de la page Créer un profil Spanner est active.
Cliquez sur RUN TEST (EXÉCUTER LE TEST) pour vérifier que Datastream peut communiquer avec la source.
Si le test échoue, examinez l'erreur et apportez les modifications nécessaires avant de relancer le test.
Cliquez sur CRÉER.
Créer un profil de connexion pour une instance Workday
Accédez à la page Profils de connexion de la console Google Cloud .
Cliquez sur CRÉER UN PROFIL.
Sur la page Créer un profil de connexion, cliquez sur le type de profil Workday.
Utilisez le tableau suivant pour renseigner les champs de la section Définir les paramètres de connexion :
Champ Description Nom du profil de connexion Saisissez le nom à afficher du profil de connexion à l'instance Workday source. ID du profil de connexion Datastream remplit automatiquement ce champ en fonction du nom que vous saisissez. Vous pouvez conserver l'ID généré automatiquement ou le modifier. Région Sélectionnez la région dans laquelle le profil de connexion est stocké. Un flux ne peut utiliser que des profils de connexion stockés dans la même région. Hôte Saisissez le nom d'hôte de votre instance Workday, par exemple wd5-impl.workday.com. Le nom d'hôte est généralement dérivé de l'URL de connexion de votre instance. Pour en savoir plus, consultez Configurer une instance Workday pour la réplication de données.Locataire Saisissez le nom court ou l'alias de votre locataire Workday, par exemple google. Cette valeur identifie votre environnement spécifique au sein de l'hôte Workday. Pour en savoir plus, consultez Configurer une instance Workday pour la réplication de données.ID client Saisissez l'ID client récupéré lors de l'enregistrement du client API dans Workday. Pour en savoir plus, consultez Configurer une instance Workday pour la réplication de données. Code secret du client Saisissez le code secret du client associé à votre client API. Vous pouvez saisir la valeur brute ou sélectionner un secret dans Secret Manager. Jeton d'actualisation Saisissez le jeton d'actualisation généré pour votre utilisateur du système d'intégration. Pour une sécurité renforcée, nous vous recommandons de stocker cette valeur dans Secret Manager. Pour en savoir plus, consultez Configurer une instance Workday pour la réplication de données. Vous pouvez également utiliser des libellés pour organiser vos ressources DataStream.
- Pour créer un libellé, cliquez sur AJOUTER UN LIBELLÉ, puis saisissez la paire clé-valeur du libellé.
- Pour supprimer le libellé, cliquez sur l'icône de corbeille à droite de la ligne correspondant au libellé.
Cliquez sur CONTINUER.
Dans la section Vérifier la méthode de connectivité, examinez les adresses IP régionales Datastream listées. Assurez-vous que votre organisation Workday est configurée pour accepter les connexions entrantes provenant de ces adresses.
Cliquez sur CONTINUER. La section Tester le profil de connexion est active.
Cliquez sur RUN TEST (EXÉCUTER LE TEST) pour vérifier que Datastream peut communiquer avec l'instance Workday source.
Cliquez sur CRÉER.
Créer un profil de connexion pour BigQuery
Accédez à la page Profils de connexion de la console Google Cloud .
Cliquez sur CRÉER UN PROFIL.
Sur la page Créer un profil de connexion, cliquez sur le type de profil BigQuery.
Renseignez les champs de la page Créer un profil BigQuery à l'aide du tableau suivant :
Champ Description Nom du profil de connexion Saisissez le nom à afficher du profil de connexion dans les ensembles de données de destination dans BigQuery. Ce nom est utilisé dans la liste des profils de connexion, ainsi que lorsqu'un profil de connexion existant est sélectionné lors de la création d'un flux. ID du profil de connexion Conservez la valeur générée automatiquement qui est renseignée dans ce champ. Région Sélectionnez la région dans laquelle le profil de connexion est stocké. Comme toutes les ressources, les profils de connexion sont enregistrés dans une région. Un flux ne peut utiliser que des profils de connexion stockés dans la même région que lui. La sélection de la région n'affecte pas la capacité de Datastream de se connecter à la source ou à la destination, mais peut affecter la disponibilité si la région subit un temps d'arrêt. Bien que la région que vous sélectionnez pour votre profil de connexion soit indépendante du type d'emplacement que vous avez sélectionné pour votre ensemble de données de destination BigQuery, nous vous recommandons de conserver toutes les ressources du flux dans la même région que vos données sources pour optimiser les coûts et les performances. Vous pouvez également utiliser des libellés pour organiser vos ressources DataStream.
- Pour créer un libellé, cliquez sur AJOUTER UN LIBELLÉ, puis saisissez la paire clé-valeur du libellé.
- Pour supprimer le libellé, cliquez sur l'icône de corbeille à droite de la ligne correspondant au libellé.
Cliquez sur CRÉER.
Créer un profil de connexion pour Cloud Storage
Accédez à la page Profils de connexion de la console Google Cloud .
Cliquez sur CRÉER UN PROFIL.
Sur la page Créer un profil de connexion, cliquez sur le type de profil Cloud Storage.
Renseignez les champs de la page Créer un profil Cloud Storage à l'aide du tableau suivant :
Champ Description Nom du profil de connexion Saisissez le nom à afficher du profil de connexion dans le bucket de destination dans Cloud Storage. Ce nom est utilisé dans la liste des profils de connexion, ainsi que lorsqu'un profil de connexion existant est sélectionné lors de la création d'un flux. ID du profil de connexion Conservez la valeur générée automatiquement qui est renseignée dans ce champ. Région Sélectionnez la région dans laquelle le profil de connexion est stocké. Comme toutes les ressources, les profils de connexion sont enregistrés dans une région. Un flux ne peut utiliser que des profils de connexion stockés dans la même région que lui. La sélection de la région n'affecte pas la capacité de Datastream de se connecter à la source ou à la destination, mais peut affecter la disponibilité si la région subit un temps d'arrêt. Nom du bucket Cliquez sur PARCOURIR pour créer ou sélectionner le bucket de destination dans Cloud Storage vers lequel Datastream transférera les données de la base de données source.
Si vous sélectionnez un bucket existant, procédez comme suit :
- Cliquez sur l'icône Rechercher (qui ressemble à une loupe).
- Dans le champ Rechercher par nom, saisissez les premiers caractères du nom du bucket que vous souhaitez sélectionner. Datastream filtre la liste des buckets pour refléter ce que vous saisissez dans le champ.
- Sélectionnez le bucket que vous souhaitez utiliser comme destination.
- Cliquez sur SELECT (SÉLECTIONNER). Votre bucket s'affiche dans le champ Nom du bucket.
Vous pouvez également cliquer sur l'icône Create new bucket (Créer un bucket) qui s'affiche sous la forme d'une mallette pour créer un bucket.
Dans le champ Préfixe de chemin du profil de connexion, vous pouvez éventuellement indiquer un préfixe pour le chemin d'accès qui sera ajouté au nom du bucket lorsque Datastream transférera des données vers la destination.
Vous pouvez également utiliser des libellés pour organiser vos ressources DataStream.
- Pour créer un libellé, cliquez sur AJOUTER UN LIBELLÉ, puis saisissez la paire clé-valeur du libellé.
- Pour supprimer le libellé, cliquez sur l'icône de corbeille à droite de la ligne correspondant au libellé.
Cliquez sur CREATE (CRÉER).
Après avoir créé des profils de connexion, vous pouvez afficher des informations générales et détaillées à leur sujet.
Étapes suivantes
- Découvrez comment modifier des profils de connexion.
- Découvrez comment afficher les profils de connexion.
- Découvrez comment supprimer des profils de connexion.
- Découvrez comment Datastream fonctionne avec les sources Dataverse.