Connexion ODBC (DataStage)
La connexion ODBC vous permet de vous connecter à une base de données avec l'API ODBC. La connexion ODBC est optimisée pour le connecteur ODBC DataStage et ne peut être utilisée que dans les flux DataStage.
La connexion et le connector ODBC offrent les bénéfices suivants :
- Affichage des messages d'erreur générés lors de l'exécution des travaux.
- Spécifiez un contrôle à granularité fine sur les propriétés d'utilisation du connecteur.
- Propriétés de connexion ou de pilote ODBC supplémentaires pour les déploiements personnalisés, tels que l'authentification de base de données LDAP ou le support de base de données volumineux.
Vous pouvez ajouter cette connexion à un espace de déploiement. Cliquez sur Importer les actifs > Accès aux données > Connexion. Voir Ajout d'actifs de données à un espace de déploiement.
Restriction
La connexion ODBC ne peut utiliser que les pilotes ODBC fournis par IBM.
Sources de données avec prise en charge SSL
Pour une connexion SSL, vous pouvez spécifier le certificat avec l'attribut TS=data:
dans la zone Propriétés supplémentaires .
Exemple :EncryptionMethod=1;AuthenticationMethod=0;ValidateServerCertificate=1;TS=data://-----BEGIN CERTIFICATE-----xxxx -----END CERTIFICATE-----
Consultez la documentation de progression de la source de données pour toute mise à jour de la syntaxe.
Créer une connexion ODBC à une source de données
- Dans la page du projet, cliquez sur l'onglet Actifs .
- Cliquez sur Nouvel actif > Connexion à une source de données.
- Sélectionnez ODBC , puis sélectionnez un type de source de données.
- Entrez les détails de la connexion.
Les sources de données suivantes sont prises en charge pour une connexion ODBC pour l'architecture x86_64
:
- Apache Cassandra
- Apache Hive
- Google BigQuery
- Greenplum
- IBM Db2
- IBM Db2 on iSeries (AS400)
- IBM Db2 on Linux on System z
- IBM Informix
- IBM Netezza
- Impala
- Microsoft SQL Server
- MongoDB
- MySQL
- Oracle
- PostgreSQL
- SAP ASE
- SAP IQ
Les sources de données suivantes sont prises en charge pour une connexion ODBC pour l'architecture s390x
:
La connexion ODBC prend en charge le connecteur IBM Cloud Satellite La tuile IBM Cloud Satellite est disponible dans la section Connectivité privée du formulaire Créer une connexion. Vous pouvez configurer un connecteur Satellite pour vous connecter en toute sécurité à votre source de données à partir d'un conteneur Docker dans votre infrastructure sur site ou configurer un emplacement Satellite avec plusieurs hôtes dans votre infrastructure, comme un centre de données sur site ou un nuage. Pour plus d'informations, voir Configuration d'un connecteur Satellite.
Apache Cassandra
Version de la bibliothèque Progress Software DataDirect ODBC : lib/VMcsndr00.so
Version du fichier Progress Software DataDirect ODBC : 08.00.0340 (B1181, U0931)
- Nom d'hôte
- Numéro de port
- Noeuds de cluster : liste séparée par des virgules de noeuds membres de votre cluster. Utilisez le format
HostName:Port,HostName:Port
. - Espace de clés : espace de clés auquel vous voulez vous connecter. Cette valeur est également utilisée comme qualificateur par défaut pour les noms de table non qualifiés dans les requêtes.
- Nom d'utilisateur et mot de passe
- Autres propriétés : entrez une liste séparée par des points-virgules de toutes les propriétés requises par le serveur Apache Cassandra. Pour connaître les propriétés disponibles, voir
Progress Connection Option Descriptions pour Apache Cassandra.
- Pour la personnalisation et la résolution des problèmes, utilisez l'attribut ConfigOptions (CO).
Restrictions relatives à Apache Cassandra
- Les modes de création et de remplacement d'écriture ne sont pas pris en charge.
- La base de données n'applique pas la contrainte de clé primaire pour insérer de nouvelles lignes uniquement et insère ensuite les modes de mise à jour. Au lieu de cela, elle met à jour cette ligne (même via le shell CQLSH).
Apache Hive
Version de la bibliothèque Progress Software DataDirect ODBC : lib/VMhive00.so
Version du fichier Progress Software DataDirect ODBC : 08.01.1035 (B2055, U1864)
- Nom de base de données
- Nom d'hôte
- Numéro de port
- Nom d'utilisateur et mot de passe
- Autres propriétés : entrez une liste séparée par des points-virgules de toutes les propriétés requises par le serveur Apache Hive. Pour connaître les propriétés disponibles, voir Progress Connection Option Descriptions pour Apache Hive.
Restrictions pour le code SQL généré pour Apache Hive
- Si le code SQL généré ne fonctionne pas, vous devez fournir votre propre instruction SQL.
- La propriété Activer les identificateurs entre guillemets n'est pas prise en charge pour la source de données Apache Hive .
- Pour prévisualiser les données, utilisez des minuscules pour la valeur de la zone Nom de la table dans les propriétés de l'étape cible.
Google BigQuery
Version de la bibliothèque DataDirect ODBC de Progress: lib/VMgbq00.so
Version du fichier DataDirect ODBC de Progress: 08.00.0357 (B1909, U1715)
- Project: nom du projet auquel se connecter. Les projets dans Google BigQuery sont équivalents aux catalogues dans ODBC. Voir Projet dans la documentation sur le progrès.
- Jeu de données: nom du jeu de données auquel se connecter. Les jeux de données dans Google BigQuery sont équivalents aux schémas dans ODBC. Voir Dataset dans la documentation Progress.
- Propriétés supplémentaires: Entrez une liste séparée par des points-virgules des propriétés requises par l'instance Google BigQuery . Pour connaître les propriétés disponibles, voir les descriptions des options de connexion àGoogle BigQuery dans la documentation Progress.
Méthode d'authentification
Sélectionnez OAuth2.0 ou Compte de service
OAuth2.0:
- ID client: clé de consommateur pour votre application
- Valeur confidentielle du client: valeur confidentielle du consommateur pour votre application.
- Jeton d'actualisation: jeton d'actualisation utilisé pour demander un nouveau jeton d'accès ou pour renouveler un jeton d'accès arrivé à expiration.
- Jeton d'accès: jeton d'accès permettant de s'authentifier auprès de l'instance Google BigQuery .
Compte de service:
- Adresse électronique du compte de service: adresse électronique associée à votre compte de service.
- Méthode d'entrée pour la clé de compte de service: Key content est sélectionné par défaut.
- Contenu de la clé de compte de service: clé privée que vous utilisez pour vous authentifier auprès de l'instance Google BigQuery .
Greenplum
Version de la bibliothèque DataDirect ODBC de Progress Software: lib/VMgplm00.so
Version du fichier DataDirect ODBC de Progress Software: 07.16.1136 (B0805, U0647)
- Nom de base de données
- Nom d'hôte
- Numéro de port
- Nom d'utilisateur et mot de passe
- Autres propriétés : entrez une liste séparée par des points-virgules de toutes les propriétés requises par le serveur Greenplum. Pour connaître les propriétés disponibles, voir Progress Greenplum Connection Option Descriptions.
Prévisualisation des données cible dans Greenplum
Si votre flux DataStage utilise le connecteur ODBC comme cible et que vous souhaitez prévisualiser les données, dans l'étape cible, sélectionnez Activer les identificateurs entre guillemets sous les propriétés de l'étape.
IBM Db2
La source de données Db2 peut être utilisée pour plusieurs types de source de données Db2 . Par exemple, Db2 sous AIX, Db2 sous Linux, Db2 sous Windows ou Db2 Warehouse.
Version de la bibliothèque DataDirect ODBC de Progress Software: lib/VMdb200.so
Version du fichier DataDirect ODBC de Progress Software: 08.02.0627 (B2069, U1878)
- Nom de base de données
- Nom d'hôte
- Numéro de port
- Nom d'utilisateur et mot de passe
- Autres propriétés : entrez une liste séparée par des points-virgules de toutes les propriétés requises par le serveur de base de données Db2. Pour connaître les propriétés disponibles, voir Progress Connection Option Descriptions for DB2.
Prévisualisation des données cible dans IBM Db2
Si votre flux DataStage utilise le connecteur ODBC comme cible et que vous souhaitez prévisualiser les données, dans l'étape cible, sélectionnez Activer les identificateurs entre guillemets sous les propriétés de l'étape.
Db2 Warehouse avec authentification SSL
Pour se connecter à une base de données qui utilise un port SSL, vous devez entrer l'attribut EncryptionMethod (EM) et l'attribut ValidateServerCertificate (VSC) comme suit dans le champ de propriétés supplémentaires de la connexion :
EM=1;AM=1;VSC=0
IBM Db2 on iSeries (AS400)
Version de la bibliothèque DataDirect ODBC de Progress Software: lib/VMdb200.so
Version du fichier DataDirect ODBC de Progress Software: 08.02.0627 (B2069, U1878)
- Nom de base de données
- Nom d'hôte
- Numéro de port
- Nom d'utilisateur et mot de passe
- Autres propriétés : entrez une liste séparée par des points-virgules de toutes les propriétés requises par le serveur de base de données Db2. Pour connaître les propriétés disponibles, voir Progress Connection Option Descriptions for DB2.
Prévisualisation des données cible dans IBM Db2 sur iSeries (AS400)
Si votre flux DataStage utilise le connecteur ODBC comme cible et que vous souhaitez prévisualiser les données, dans l'étape cible, sélectionnez Activer les identificateurs entre guillemets sous les propriétés de l'étape.
IBM Db2 on Linux on System z
Version de la bibliothèque DataDirect ODBC de Progress Software: lib/VMdb200.so
Version du fichier DataDirect ODBC de Progress Software: 08.02.0627 (B2069, U1878)
- Nom de base de données
- Nom d'hôte
- Numéro de port
- Nom d'utilisateur et mot de passe
- Autres propriétés : entrez une liste séparée par des points-virgules de toutes les propriétés requises par le serveur de base de données Db2. Pour connaître les propriétés disponibles, voir Progress Connection Option Descriptions for DB2.
IBM Informix
Version de la bibliothèque DataDirect ODBC de Progress Software: lib/VMifcl00.so
Version du fichier DataDirect ODBC de Progress Software: 08.02.0124 (b9990, U1362)
- Nom de base de données
- Nom d'hôte
- Numéro de port
- Nom d'utilisateur et mot de passe
- Autres propriétés : entrez une liste séparée par des points-virgules de toutes les propriétés requises par le serveur de base de données Informix. Pour connaître les propriétés disponibles, voir Progress Connection Option Descriptions pour Informix.
Restriction pour IBM Informix
Les caractères Unicode ne sont pas pris en charge pour la source de données ODBC Informix .
IBM Netezza
Version de la bibliothèque DataDirect ODBC du logiciel de progression: libnzodbc.so
- Nom de base de données
- Nom d'hôte
- Numéro de port
- Nom d'utilisateur et mot de passe
Prévisualisation des données cible dans IBM Netezza
Si votre flux DataStage utilise le connecteur ODBC comme cible et que vous souhaitez prévisualiser les données, dans l'étape cible, sélectionnez Activer les identificateurs entre guillemets sous les propriétés de l'étape.
Impala
Version de la bibliothèque Progress Software DataDirect ODBC : lib/VMimpala00.so
Version du fichier Progress Software DataDirect ODBC : 07.16.0515 (B0805, U0647)
- Nom de base de données
- Nom d'hôte
- Numéro de port
- Nom d'utilisateur et mot de passe
- Autres propriétés : entrez une liste séparée par des points-virgules de toutes les propriétés requises par le serveur de base de données Impala. Pour connaître les propriétés disponibles, voir Progress Connection Option Descriptions pour Impala.
Microsoft SQL Server
La source de données Microsoft SQL Server peut être utilisée pour plusieurs types de source de données. Par exemple, Microsoft SQL Serverautonome, Microsoft Azure SQL Databaseou Azure Synapse SQL.
Version de la bibliothèque DataDirect ODBC de Progress Software: lib/VMsqls00.so
Version du fichier DataDirect ODBC de Progress Software: 08.02.1500 (B2058, U1867)
- Nom de base de données
- Nom d'hôte
- Numéro de port
- Nom d'utilisateur et mot de passe
- Propriétés supplémentaires : Entrez une liste séparée par un point-virgule de toutes les propriétés requises par Microsoft SQL Server. Pour connaître les propriétés disponibles, voir Progress Connection Option Descriptions pour Microsoft SQL Server.
Incluez le nom de domaine Windows et la méthode d'authentification dans la zone Propriétés supplémentaires .
Par exemple :Domain=myco;AM=1;
MongoDB
Progress Software DataDirect ODBC version de la bibliothèque: lib/VMmongo00.so
Progress Software DataDirect ODBC version du fichier: 08.10.0248 (B2064, U1873)
- Nom de base de données
- Nom d'hôte
- Numéro de port
- Nom d'utilisateur et mot de passe
- Autres propriétés : entrez une liste séparée par des points-virgules de toutes les propriétés requises par le serveur MongoDB. Pour connaître les propriétés disponibles, voir
Progress Connection Option Descriptions pour MongoDB.
- Pour la personnalisation et la résolution des problèmes, utilisez l'attribut ConfigOptions (CO).
MongoDB avec authentification SSL
Pour vous connecter à une base de données qui utilise un port SSL, vous devez entrer l'attribut EncryptionMethod (EM) et l'attribut ValidateServerCertificate (VSC) comme suit dans le champ de propriétés supplémentaires de la connexion :
EM=1;AM=1;VSC=0
Restrictions pour MongoDB
- Pour utiliser la source de données MongoDB comme cible, vous devez entrer
ReadOnly=0
dans la connexion des propriétés supplémentaires. - Les types de données complexes ne sont pas acceptés
- Pour les collections imbriquées, vous devez soit aplatir le schéma, soit normaliser le schéma et utiliser les requêtes appropriées. Voir les informations sur l'attributSchemaFormat.
- Les modes d'écriture Créer et Remplacer ne sont pas pris en charge
- L'insertion avec les modes de violation de clé primaire, Insérer de nouvelles lignes uniquement et Insérer puis mettre à jour n'est pas prise en charge (limitation de la base de données)
- Les vues ne sont pas prises en charge
- Les types de données suivants ne sont pas pris en charge comme cibles :
- Date :
- Décimal
- Numérique
- Durée
- Horodatage
MySQL
Version de la bibliothèque DataDirect ODBC de Progress Software: lib/VMmysql00.so
Version du fichier DataDirect ODBC de Progress Software: 08.02.0466 (B1697, U1497)
- Nom de base de données
- Nom d'hôte
- Numéro de port
- Nom d'utilisateur et mot de passe
- Autres propriétés : entrez une liste séparée par des points-virgules de toutes les propriétés requises par le serveur de base de données MySQL. Pour connaître les propriétés disponibles, voir Progress Connection Options Descriptions pour MySQL.
Restriction pour MySQL
Les serveurs MySQL Community Edition ne sont pas pris en charge.
Oracle
La source de données Oracle peut être utilisée pour d'autres types de source de données Oracle . Par exemple, Amazon RDS pour Oracle.
Version de la bibliothèque ODBC de Progress Software DataDirect: Pilote OracleClient-based: lib/VMor800.so. Oracle Wire Protocol : lib/VMora00.so
Version du fichier ODBC de Progress Software DataDirect: Pilote OracleClient-based: 07.16.0221B0572, U0414). Oracle Wire: 08.02.3140 (B2076, U1885)
- Nom d'hôte
- Numéro de port
- Nom du service : nom du service Oracle qui spécifie la base de données.
- Nom d'utilisateur et mot de passe
- Autres propriétés : entrez une liste séparée par des points-virgules de toutes les propriétés requises par le serveur de base de données Oracle. Pour connaître les propriétés disponibles, voir Progress Connection Option Descriptions pour Oracle.
Prévisualisation des données cible dans Oracle
Si votre flux DataStage utilise le connecteur ODBC comme cible et que vous souhaitez prévisualiser les données, dans l'étape cible, sélectionnez Activer les identificateurs entre guillemets sous les propriétés de l'étape.
PostgreSQL
La source de données PostgreSQL peut être utilisée pour d'autres types de source de données PostgreSQL. Par exemple, Amazon RDS for PostgreSQL ou IBM Cloud Databases for PostgreSQL.
Version de la bibliothèque DataDirect ODBC de Progress Software: lib/VMpsql00.so
Version du fichier DataDirect ODBC de Progress Software: 08.02.2505 (B2078, U1890)
- Base de données
- Nom d'hôte
- Numéro de port
- Nom d'utilisateur et mot de passe
- Autres propriétés : entrez une liste séparée par des points-virgules de toutes les propriétés requises par le serveur de base de données PostgreSQL. Pour connaître les propriétés disponibles, voir Progress Connection Option Descriptions for PostgreSQL Wire Protocol.
Prévisualisation des données cible dans PostgreSQL
Si votre flux DataStage utilise le connecteur ODBC comme cible et que vous souhaitez prévisualiser les données, dans l'étape cible, sélectionnez Activer les identificateurs entre guillemets sous les propriétés de l'étape.
PostgreSQL avec authentification SSL
Pour se connecter à une base de données qui utilise un port SSL, vous devez entrer l'attribut EncryptionMethod (EM) et l'attribut ValidateServerCertificate (VSC) comme suit dans le champ de propriétés supplémentaires de la connexion :
EM=1;AM=1;VSC=0
SAP ASE
Version de la bibliothèque Progress Software DataDirect ODBC : lib/VMase00.so
Version du fichier Progress Software DataDirect ODBC : 07.16.0373 (B0805, U0647)
- Nom de base de données
- Adresse réseau : nom ou adresse IP du serveur SAP ASE suivi d'une virgule et du numéro de port.
Par exemple,server-name,5000
ou192.0.2.0,5000
. - Nom d'utilisateur et mot de passe
- Autres propriétés : entrez une liste séparée par des points-virgules de toutes les propriétés requises par le serveur SAP ASE. Pour connaître les propriétés disponibles, voir Progress Connection Option Descriptions for Sybase Wire Protocol.
SAP IQ
Progress Software DataDirect ODBC version de la bibliothèque: lib/VMsyiq00.so
Progress Software DataDirect Version du fichier ODBC : 08.02.0279 (B2038, U1847)
- Nom de base de données
- Adresse réseau : nom ou adresse IP du serveur SAP IQ suivi d'une virgule et du numéro de port.
Par exemple,server-name,5000
ou192.0.2.0,5000
. - Nom d'utilisateur et mot de passe
- Autres propriétés : entrez une liste séparée par des points-virgules de toutes les propriétés requises par le serveur SAP IQ. Pour connaître les propriétés disponibles, voir Progress Connection Option Descriptions pour SAP IQ.
En savoir plus
Connexion à une source de données dans DataStage
Rubrique parent : Connexions prises en charge