procédure stockée setRdbcX dans la Data Virtualization | IBM Cloud Pak for Data as a Service

Retourner à la version anglaise de la documentation

Procédure mémorisée setRdbcX (variante 1)

Dernière mise à jour : 26 nov. 2024

procédure stockée setRdbcX dans la Data Virtualization

Définit une nouvelle connexion de source de données sur un ou plusieurs nœuds finaux. Cette variante est destinée à être utilisée avec des paramètres basés sur l'URL. Le schéma est DVSYS.

Paramètres d'entrée

pilote

Le type de ce paramètre requis est VARCHAR (128). Indique la classe du pilote de source de données.

URI

Le type de ce paramètre requis est VARCHAR (2000). Indique l'URI de connexion de la source de données.

utilisateur

Le type de ce paramètre facultatif est VARCHAR (128). Indique un nom d'utilisateur de source de données.

Mot de passe

Le type de ce paramètre facultatif non chiffré est VARCHAR (128). Spécifie un mot de passe de source de données.

trust_store_location

Le type de ce paramètre facultatif est VARCHAR (128). Indique une marque de réservation dans l'URI pour l'emplacement réel du fichier de clés certifiées qui contient le certificat.

Certificat_SSL

Le type de ce paramètre facultatif est VARCHAR (32672). Indique un certificat de serveur de source de données, si nécessaire.

ID_pilote

Le type de ce paramètre facultatif est VARCHAR (128). Indique l'ID du pilote à utiliser lorsque vous demandez le téléchargement d'un pilote à partir du serveur API.

node_name

Le type de ce paramètre requis est VARCHAR (32672). Indique les noms des nœuds sur lesquels la source de données est définie.

Exécutez la requête suivante pour trouver des valeurs valides pour node_name.

SELECT * FROM DVSYS.LISTNODES;

Options supplémentaires

Le type de ce paramètre facultatif est VARCHAR (32672). Indique une liste délimitée par des virgules de paramètres supplémentaires au format suivant :

'<key1>=<value1>, <key2>=<value2>,
...'

. Les options prises en charge sont EDITERD, DRIVERID et JWTTOKEN. Si vous indiquez EDITERD, les informations de connexion existantes sont remplacées par les nouvelles informations que vous fournissez. Par exemple :

call DVSYS.setRdbcX('old_dsDriver', 'old_dsUrl', 'old_usr', 'newP@ssw0rd', '', '', '', 'NodeIdForMyDB2', 'EDITCID=MYSQL11941', ?, ?, ?)

DRIVERID (ID du pilote à télécharger) et JWTTOKEN (jeton Web Java) sont utilisés ensemble lorsque ces paramètres sont définis. Le connecteur / nœud final télécharge le pilote depuis le serveur.

Restrictions d'accès : Utilisez cette option pour activer les restrictions d'accès Data Virtualization. Ajoutez les restrictions sous la forme d'une liste imbriquée de tuples séparés par des virgules spécifiant le type de bénéficiaire d'accès (utilisateur, groupe ou rôle) et leurs noms. Par exemple :

ACCESS_RESTRICTION={U username, G groupname, R rolename}

N'utilisez pas de guillemets pour encapsuler les noms. Par exemple, utilisez ACCESS_RESTRICTION={G ALL USERS} à la place de ACCESS_RESTRICTION={G "ALL USERS"}.

Paramètres de sortie

ID_connexion: Le type de ce paramètre est VARCHAR (20). Représente l'identifiant de connexion généré pour la Data Virtualization.
Nombre_de_connexions_définies: Le type de ce paramètre est INTEGER. Représente le nombre total de connexions ajoutées.
diagnostics: Le type de ce paramètre est VARCHAR (32672). Représente la sortie de diagnostic en cas d'échec.

Exemple

call DVSYS.setRdbcX('com.ibm.jdbc.oracle.OracleDriver', 'jdbc:ibm:oracle://90.30.146.185:1521;serviceName=pdborcl.test.ibm.com', '<username>', '<password>', null, null, '', 'qpendpoint_1:6415', '', ?, ?, ?)"

Si vous souhaitez éditer une source de données avec un nouveau mot de passe, vous pouvez utiliser le paramètre additional_options avec EDITERD.

call DVSYS.setRdbcX('com.ibm.jdbc.oracle.OracleDriver', 'jdbc:ibm:oracle://90.30.146.185:1521;serviceName=pdborcl.test.ibm.com', '<username>', '<new_password>', null, null, '', 'qpendpoint_1:6415', 'EDITCID=ORAC003', ?, ?, ?)"