Configurando um Provedor JDBC para Conexões Tipo 4

Utilize o comando mqsicreateconfigurableservice ou mqsichangeproperties para configurar um serviço de provedor JDBC.

Antes de começar:
Quando você inclui um nó DatabaseRetrieve, DatabaseRoute, JavaCompute,Início da mudança Mapeamento,Fim da mudança ou Java definido pelo usuário em um fluxo de mensagens e interage com um banco de dados nesse nó, o broker precisa estabelecer uma conexão com o banco de dados para cumprir as operações que são executadas pelo nó. Você deve definir um serviço configurável JDBCProvider para fornecer ao broker as informações que precisa para concluir a conexão.
Importante: Início da mudançaAo nomear seu serviço JDBCProvider, considere os seguintes requisitos:
  • Se você desejar usar o serviço JDBCProvider com um nó JavaCompute ou, com um nó Java definido pelo usuário, o nome do serviço JDBCProvider deverá corresponder ao parâmetro datasourceName na chamada getJDBCType4Connection() do nó.
  • Se desejar usar o serviço JDBCProvider com um nó Mapeamento, o nome do serviço JDBCProvider deve corresponder ao nome do banco de dados que é usado pelas conversões de banco de dados em seu Mapa de Dados Gráfico. Para cada conversão de banco de dados, o nome do banco de dados é determinado pela definição de banco de dados (arquivo .dbm) no projeto de Design de Dados que foi usado para criar o mapa.
  • Se desejar usar o serviço JDBCProvider com um nó DatabaseRetrieve ou com um nó DatabaseRoute, o nome do serviço JDBCProvider deve corresponder ao valor da propriedade Nome da origem de dados do nó.
Fim da mudança

Um serviço configurável JDBCProvider suporta conexões a somente um banco de dados; você deve criar um serviço para cada banco de dados ao qual seus nós ou aplicativos Java se conectem.

Para configurar um provedor JDBC para conexões tipo 4 usando o WebSphere Message Broker Explorer, consulte Criando um Novo Serviço Configurável.

Para configurar um provedor JDBC para conexões tipo 4 usando os comandos mqsicreateconfigurableservice ou mqsichangeproperties, conclua as seguintes etapas:

  1. Identifique o tipo de banco de dados para o qual é necessário um serviço JDBCProvider.

    Os drivers JDBC e bancos de dados suportados são mostrados em Bancos de Dados Suportados; o suporte para transações coordenadas globalmente (XA) é restrito em algumas plataformas e para alguns bancos de dados.

  2. Execute o comando mqsireportproperties para visualizar a lista de serviços JDBCProvider disponíveis. Substitua o nome de seu broker no lugar de broker_name.
    mqsireportproperties broker_name -c JDBCProviders -a -o AllReportableEntityNames

    A resposta do comando lista todos os serviços configuráveis JDBCProvider que estão definidos. Se você não tiver criado suas próprias definições, a seguinte lista de serviços padrão fornecidos será mostrada:

    • DB2
    • Informix
    • Informix_With_Date_Format
    • Microsoft_SQL_Server
    • Oracle
    • Sybase_JConnect6_05

    Se estiver conectado a um banco de dados Informix:

    • Use Informix_With_Date_Format para compatibilidade com aplicativos clientes dependentes do atributo de conexão de formato de data que foi utilizado por versões anteriores dos servidores Informix.
    • Utilize Informix para aplicativos clientes que não dependem do atributo de formato de data.
  3. Visualize o conteúdo da definição de serviço JDBCProvider relevante. Por exemplo, execute o seguinte comando para exibir a definição Oracle fornecida:
    mqsireportproperties broker_name -c JDBCProviders -o Oracle -r

    A resposta do comando lista todas as propriedades para a definição do Oracle. Se não tiver alterado essa definição, as propriedades são configuradas para valores iniciais, alguns dos quais você deve alterar para criar uma definição viável. Por exemplo, a propriedade databaseName está configurada como default_Database_Name e você deve alterá-la para identificar o banco de dados específico ao qual deseja se conectar.

    Um serviço JDBCProvider possui as seguintes propriedades:

    • connectionUrlFormat. Um padrão que representa a definição da conexão URL, que é específica para um tipo de banco de dados particular. Por exemplo, o padrão para DB2 é definido com o seguinte conteúdo:
      jdbc:db2://[serverName]:[portNumber]/[databaseName]:user=[user];password=[password];

      O padrão é utilizado e concluído pelo broker no tempo de execução quando ele se conecta ao banco de dados. Os valores entre colchetes, por exemplo [serverName], são substituídos pelo broker para o padrão usando os valores especificados nos comandos mqsicreateconfigurableservice, mqsichangeproperties ou mqsisetdbparms.

      Os valores e a ordem de preferência a seguir são usados pelo broker para substituir o ID do usuário e a senha no padrão:

      1. Primeiro, em todas as plataformas: O ID do usuário e a senha que você configurou para o banco de dados específico, usando o mqsisetdbparms e especificando o banco de dados no parâmetro -n.
      2. Segundo, em todas as plataformas: O ID do usuário e a senha que você configurou para todos os outros bancos de dados, usando o mqsisetdbparms e especificando jdbc::JDBC no parâmetro -n.
      3. Terceiro, os valores são específicos da plataforma:
        1. Windows platform No Windows: O ID de serviço e a senha do broker especificados no comando mqsicreatebroker.
        2. Linux platformUNIX platform No Linux e UNIX: O ID do usuário mqsiUser e senha ******** (estes valores são fixos).
        3. z/OS platform No z/OS: O ID do usuário "" e a senha "".

      Se estiver usando um dos serviços JDBCProvider fornecidos, não use o comando mqsichangeproperties para alterar o próprio padrão; as mudanças feitas no padrão podem causar resultados imprevisíveis.

      Se você usar o comando mqsicreateconfigurableservice para definir seu próprio serviço JDBCProvider, use o comando mqsireportproperties para verificar se o conteúdo da cadeia connectionUrlFormat corresponde exatamente ao provedor padrão fornecido para o tipo de banco de dados que está sendo usado.

      Além disso, se você estiver trabalhando no z/OS e estiver usando os arquivos da JCL BIPCRCS e BIPCHPR para definir seu serviço JDBCProvider, certifique-se de que seu emulador 3270 esteja configurado para usar a mesma página de códigos na qual o broker está em execução. Se as páginas de códigos não corresponderem, o padrão de cadeia connectionUrlFormat definido pode não ser reconhecido corretamente pelo broker.

    • connectionUrlFormat Attr1-5. Se o padrão de URL definido para um banco de dados contiver propriedades da origem de dados JDBC não-padrão, como um identificador de serviço, especifique estas propriedades, além dos atributos padrão, usando um de cinco atributos de URL de conexão de propósito geral. Exemplo:
      • Se connectionURLFormat = jdbc:oracle:thin:[user]/[password]@[serverName]:[portNumber]:[connectionUrlFormatAttr1], connectionUrlFormatAttr1 deverá conter um identificador de servidor Oracle, que você deve fornecer definindo o valor para a propriedade connectionUrlFormatAttr1 no comando mqsicreateconfigurableservice ou mqsichangeproperties. O broker, então, pode substituir todos os valores necessários no padrão exigido.
      • Se connectionURLFormat = jdbc:informix-sqli://[serverName]:[portNumber]/[databaseName]:informixserver=[connectionUrlFormatAttr1]; user=[user];password=[password], connectionUrlFormatAttr1 deverá conter o nome da instância do Informix no servidor (geralmente especificado pela variável de ambiente INFORMIXSERVER). Este valor faz distinção entre maiúsculas e minúsculas.
    • databaseName. O nome do banco de dados para o qual a entrada da origem de dados ativa conexões; por exemplo, employees.
    • Início da mudançadatabaseSchemaNames. Opcionalmente, substitua o nome do esquema do banco de dados usado em instruções SQL criadas pelos nós do fluxo de mensagens. Essa propriedade é usada apenas pelo nó Mapeamento e apenas ao chamar um mapa de dados gráfico que contenha uma conversão de banco de dados. Para obter informações adicionais, consulte Serviço Configurável JDBCProviders.Fim da mudança
    • databaseType. O tipo de banco de dados; por exemplo, DB2.
    • databaseVersion. A versão do banco de dados; por exemplo, 9.1.
    • description. Uma propriedade opcional para descrever a definição da origem de dados.
    • environmentParms. Apenas para DB2. Uma propriedade opcional que especifica uma lista de propriedades de origem de dados no formato name=value, cada uma separada por um ponto e vírgula.
    • jarsURL. O caminho do diretório local no sistema em que o intermediário está em execução, no qual o arquivo JAR que contém a classe do driver tipo 4 está localizado.

      Além disso, um disco de rede de área de armazenamento pode ser usado para o caminho do diretório, mas uma unidade de rede mapeada para um computador remoto não pode ser usada.

    • portNumber. O número da porta na qual o servidor de servidor de banco de dados está atendendo; por exemplo, 50000.
    • securityIdentity. Uma chave de segurança exclusiva para executar uma segunda consulta de registro do broker para localizar uma entrada nas identidades de segurança do broker, que armazenam a senha criptografada para o usuário no sistema host associado; por exemplo, mysecurityIdentity.

      Crie uma identidade de segurança usando o comando mqsisetdbparms, conforme descrito em Protegendo uma Conexão JDBC Tipo 4. O valor de securityIdentity (por exemplo, mysecurityIdentity) deve corresponder ao valor que você especifica após o prefixo jdbc:: para o parâmetro -n nesse comando.

      A identidade de segurança fornece um par de valores de ID do usuário e senha, que são usados para acessar a origem de dados especificada, definida para uma determinada entrada de serviço JDBCProvider. Esta propriedade será ignorada se a URL de conexão não contiver um par de ID do usuário e senha que requerem valores da propriedade para substituição para essas inserções.

      Os valores-padrão, que você pode configurar especificando um ResourceName igual a jdbc::JDBC no comando mqsisetdbparms, são usados sob as seguintes condições:

      • Se o securityIdentity estiver em branco ou se você não o tiver alterado a partir do valor padrão default_User@default_Server, mas a identidade for necessária para o padrão da URL da conexão.
      • Se você tiver inserido uma chave de identidade de segurança exclusiva válida, mas ela não puder ser encontrada sob a chave DSN.
    • serverName. O nome do servidor; por exemplo, host1.
    • type4DatasourceClassName. O nome da classe de origem de dados JDBC utilizado para estabelecer uma conexão tipo 4 com um banco de dados remoto e para suporte a transações coordenadas. Por exemplo, especifique com.ibm.db2.jcc.DB2XADataSource para DB2 ou especifique oracle.jdbc.xa.client.OracleXADataSource para Oracle. Você deve especificar o nome da classe XA ao usar a chamada getJDBCType4ConnectionAPI() para transações coordenadas. Se o servidor de banco de dados não suportar transações XA ou você não desejar usar o protocolo XA, essa propriedade será opcional e você deverá configurar a propriedade jdbcProviderXASupport como false.
    • type4DriverClassName. O nome da classe do driver JDBC tipo 4 usado para estabelecer uma conexão. Por exemplo, especifique com.ibm.db2.jcc.DB2Driver para DB2 ou especifique oracle.jdbc.OracleDriver para Oracle.
    • Início da mudançajdbcProviderXASupport. Uma propriedade opcional que controla se o broker se conecta a um servidor de banco de dados usando o Protocolo XA. Por padrão, essa propriedade é configurada como true. Se o servidor de banco de dados não estiver ativada para Suporte XA, ou transações coordenadas não forem necessárias, configure o valor como false. Nesse caso, será usado o driver tipo 4 especificado usando a propriedade type4DriverClassName, em vez da origem de dados tipo 4 especificada na propriedade type4DatasourceClassName.Fim da mudança
  4. Se desejar usar a definição fornecida, execute o comando mqsichangeproperties para substituir valores-padrão por valores específicos de seu banco de dados e ambiente. Se tiver qualquer dúvida sobre os valores necessários, consulte o administrador do seu banco de dados ou verifique a documentação fornecida com o banco de dados que você escolheu. Alguns valores dependem de como e onde você instalou o produto do banco de dados; por exemplo, a propriedade jarsURL identifica o local dos arquivos JAR fornecidos e instalados pelo provedor de banco de dados.
  5. Se desejar criar um novo serviço configurável, talvez porque você deseja manter o serviço fornecido como um modelo para definições futuras, execute o comando mqsicreateconfigurableservice para criar a definição.
    mqsicreateconfigurableservice broker_name -c JDBCProviders -o provider_name 
    -n list of properties -v list of values

    Insira o comando em uma única linha; o exemplo foi dividido para melhorar a capacidade de leitura.

    Especifique todas as propriedades que são necessárias para o provedor de banco de dados escolhido. Para especificar uma lista de propriedades e valores, separe os itens após cada sinalizador com uma vírgula. Por exemplo, -n databaseName,databaseType -v EmployeeDB,DB2. Se você não especificar todas as propriedades no comando mqsicreateconfigurableservice, é possível atualizá-las posteriormente com o comando mqsichangeproperties.

  6. Quando tiver configurado seu serviço JDBCProvider, você deve parar e reiniciar o intermediário.
  7. Quando tiver configurado ou modificado seu serviço JDBCProvider, conclua uma das seguintes ações:
    • Reinicie ou reimplemente cada aplicativo ou fluxo de mensagens que use o serviço JDBCProvider.
    • Reinicie cada grupo de execução que contenha aplicativos ou fluxos de mensagens que usem o serviço JDBCProvider.
    • Reinicie o broker no qual você configurou ou modificou o serviço JDBCProvider.
A seguir: Se necessário, configure a segurança para a conexão JDBC, configure o ambiente para incluir o serviço JDBCProvider em transações coordenadas globalmente, ou ambos.
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
        Última atualização
        
        Última atualização : 2012-07-17 10:03:57


Tópico de TarefaTópico de Tarefa | Versão 8.0.0.1 | ah61310_