Procedimento armazenado setRdbcX (Variação 2)

Define uma nova conexão de origem de dados em um ou mais nós de terminal. Essa variação é destinada ao uso com parâmetros discretos. O esquema é DVSYS.

Parâmetros de entrada

src_type

O tipo desse parâmetro necessário é VARCHAR(20). Especifica o tipo de origem de dados.

host_name

O tipo desse parâmetro necessário é VARCHAR(2000). Especifica o nome do host de origem de dados.

db_port

O tipo desse parâmetro necessário é INTEGER. Especifica a porta de rede do serviço de origem de dados.

database_name

O tipo desse parâmetro opcional é VARCHAR(128). Especifica o nome do banco de dados para a conexão.

connection_options

O tipo desse parâmetro opcional é VARCHAR(2000). Especifica uma lista delimitada por vírgulas de opções extra no formato a seguir:

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

Usuário

O tipo desse parâmetro necessário é VARCHAR(128). Especifica um nome de usuário do banco de dados.

senha

O tipo desse parâmetro necessário não criptografado é VARCHAR(128). Especifica uma senha de usuário de banco de dados.

use_SSL

O tipo desse parâmetro necessário é INTEGER. Especifica se a conexão com o banco de dados usa SSL. Os valores válidos são 0 (a conexão não usa SSL) e 1 (a conexão usa SSL).

validate_cert

O tipo desse parâmetro necessário é INTEGER. Especifica se o terminal valida o certificado SSL do servidor de banco de dados. Os valores válidos são 0 (sem validação) e 1 (validação é necessária).

cert_host_name

O tipo desse parâmetro opcional é VARCHAR(2000). Especifica o nome do host que está associado ao certificado SSL. A especificação de uma sequência de caracteres vazia ou do valor nulo impede a validação do nome do host.

SSL_certificate

O tipo desse parâmetro opcional é VARCHAR(32672). Especifica um certificado de servidor de banco de dados, se necessário.

node_name

O tipo desse parâmetro necessário é VARCHAR(32672). Especifica os nomes dos nós nos quais a origem de dados é definida.

Execute a seguinte consulta para localizar valores válidos para node_name.

SELECT * FROM DVSYS.LISTNODES;

additional_options

O tipo desse parâmetro opcional é VARCHAR(32672). Especifica uma lista delimitada por vírgulas de parâmetros extra no formato a seguir:

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

. As opções suportadas incluem EDITCID, DRIVERID e JWTTOKEN. Se você especificar EDITCID, as informações de conexão existentes serão substituídas pelas novas informações fornecidas. Por exemplo:

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

DRIVERID (o ID do driver que deve ser transferido por download) e JWTTOKEN (o Java web token) são usados juntos quando esses parâmetros são configurados. O conector/terminal faz o download do driver do servidor.

Restrições de acesso: Use essa opção para ativar as restrições de acesso à Data Virtualization. Inclua as restrições na forma de uma lista separada por vírgula aninhada de tuplas que especificam o tipo de acesso concedido (usuário, grupo ou função) e seus nomes. Por exemplo:

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

Não use aspas para agrupar os nomes. Por exemplo, use ACCESS_RESTRICTION={G ALL USERS} em vez de ACCESS_RESTRICTION={G "ALL USERS"}..

Parâmetros de saída

connection_ID: O tipo desse parâmetro é VARCHAR(20). Representa a ID de conexão gerada para a Data Virtualization.
numer_of_defined_connections: O tipo desse parâmetro é INTEGER. Representa o número total de conexões incluídas.
diagnósticos: O tipo desse parâmetro é VARCHAR(32672). Representa a saída de diagnóstico se ocorrer uma falha.

Sintaxe

Use a seguinte sintaxe e substitua os parâmetros para este procedimento armazenado:

call DVSYS.setRdbcX('<src_type>','<host_name>','<db_port>','<database_name>','<connection_options>','<user>','<password>','<use_SSL>','<validate_cert>','<cert_host_name>','<SSL_certificate>','<node_name>','<additional_options>',?,?,?);

Exemplos

call DVSYS.setRdbcX('DB2','9.30.167.128','50000','TPCDS','','<user>','<password>','0','0','','','qpendpoint_1:6415','',?,?,?);

Se você deseja editar uma fonte de dados com uma nova senha, pode usar o additional_options parâmetro com EDITCID :

call DVSYS.setRdbcX('DB2','9.30.167.128','50000','TPCDS','','<user>','<password>','0','0','','','qpendpoint_1:6415','EDITCID=DB2002',?,?,?);

Neste exemplo, a opção específica da DB2_VARCHAR_BLANKPADDED_COMPARISON Federação é aplicada:

call DVSYS.setRdbcX('MongoDB', '', '31365', '', '', 'admin', 'adminpassword', '1', '0', '', '', 'qpendpoint_1', 'MIN_POOLSIZE=7,MAX_POOLSIZE=22,DB2_VARCHAR_BLANKPADDED_COMPARISON=N',?,?,?);