Criar perfis de conexão

Antes de criar um stream no Datastream, configure perfis de conexão que armazenam configurações reutilizáveis de autenticação e conectividade de rede para recursos na mesma região.

É possível criar perfis de conexão de origem para Oracle, MySQL, PostgreSQL, SQL Server, MongoDB, Spanner, Salesforce, Salesforce Marketing Cloud, ServiceNow, Microsoft Dataverse ou Workday. Para destinos, é possível criar perfis de conexão para conjuntos de dados do BigQuery ou um bucket do Cloud Storage.

Antes de começar

• Verifique se você configurou o banco de dados de origem para replicação. Para informações sobre as etapas necessárias para cada tipo de origem compatível, consulte Configurar origens.
• Saiba quais etapas podem ser necessárias para configurar o destino selecionado. Para mais informações, consulte Configurar destinos.

Criar um perfil de conexão para banco de dados Oracle

1. Acesse a página Perfis de conexão no console do Google Cloud .

   Acessar a página "Perfis de conexão"

2. Clique em CRIAR PERFIL.

3. Na página Criar um perfil de conexão, clique no tipo de perfil Oracle.

4. Use a tabela a seguir para preencher os campos da seção Define connection settings da página Create Oracle profile:

   Campo	Descrição
   Nome do perfil de conexão	Digite o nome de exibição do perfil de conexão com o banco de dados Oracle de origem. É usado na lista de perfis de conexão e também quando um perfil de conexão existente é selecionado na criação de um stream.
   ID do perfil de conexão	O Datastream preenche esse campo automaticamente com base no nome do perfil de conexão inserido. É possível manter o ID gerado automaticamente ou alterá-lo.
   Região	Selecione a região em que o perfil de conexão é armazenado. Os perfis de conexão, assim como todos os recursos, são salvos em uma região, e um stream só pode usar perfis de conexão armazenados na mesma região do stream. A seleção de região não afeta a capacidade do Datastream de se conectar à origem ou ao destino, mas pode afetar a disponibilidade se a região tiver um período de inatividade.
   IP ou nome do host	Insira um nome do host ou endereço IP que o Datastream possa usar para se conectar ao banco de dados Oracle de origem. Se você estiver usando conectividade privada para se comunicar com o banco de dados de origem, especifique o endereço IP particular (interno) do banco de dados de origem. Se você estiver usando um proxy reverso para conectividade privada, use o endereço IP do proxy. Para outros métodos de conectividade, como lista de permissões de IP, informe o endereço IP público.
   Porta	Digite o número reservado para o banco de dados de origem (a porta padrão geralmente é 1521).
   Username	Digite o nome de usuário da conta para o banco de dados de origem (por exemplo, ROOT). Esse é o usuário do Datastream que você criou para o banco de dados. Para mais informações sobre como criar esse usuário, consulte Configurar seu banco de dados Oracle de origem.
   Selecionar a senha do Secret Manager	Selecione esta opção se quiser autenticar com um secret em vez de inserir a senha manualmente. Ao selecionar essa opção, dois menus suspensos aparecem: Secret: selecione um secret na lista (se disponível), insira-o manualmente ou crie um novo secret: Para inserir um secret manualmente: Clique em Inserir secret manualmente. A caixa de diálogo Adicionar um secret por ID do recurso é exibida. Copie e cole o identificador do recurso do secret do Secret Manager. O ID do recurso do secret pode ter o seguinte formato: projects/PROJECT_NUMBER/secrets/SECRET_NAME (versão mais recente) projects/PROJECT_NUMBER/secrets/SECRET_NAME/versions/VERSION_NUMBER (versão específica) Clique no botão Adicionar secret. Para criar um secret: Clique em Criar secret. O painel lateral Detalhes do secret é aberto. Em Nome, insira um nome para o secret (por exemplo, my-secret). O nome do secret pode conter letras maiúsculas e minúsculas, numerais, hifens e sublinhados. O comprimento máximo permitido para um nome é de 255 caracteres. O nome que você criar será adicionado como parte do identificador do recurso do secret. Opcional: para adicionar uma versão do secret ao criar o secret inicial, no campo Valor do secret, digite um valor (por exemplo, abcd1234). O valor do secret pode estar em qualquer formato, mas não pode ultrapassar 64 KiB. Também é possível fazer upload de um arquivo de texto com o valor do secret usando a opção Fazer upload do arquivo. Clique no botão Criar secret. Versão do secret: insira a versão do secret que você quer usar: Quando você fornece o identificador de recurso do secret, a caixa de seleção Usar a versão mais recente aparece. Selecione essa opção para usar a versão mais atualizada do recurso de secret. Como alternativa, você pode expandir o menu suspenso Versão do secret e selecionar a versão na lista, se disponível. Se você quiser usar uma versão diferente do secret, siga estas etapas: Clique em Adicionar nova versão. No campo Valor do secret, insira um valor para o secret. Como alternativa, é possível fazer upload de um arquivo que contenha o valor do secret. Clique no botão Adicionar nova versão.
   Inserir senha manualmente	Como alternativa, é possível inserir manualmente a senha da conta do banco de dados de origem.
   Identificador do sistema (SID, na sigla em inglês)	Insira o serviço que garante que o banco de dados Oracle de origem seja protegido e monitorado. Para bancos de dados Oracle, o serviço de banco de dados normalmente é ORCL. Para bancos de dados plugáveis, o SID é o nome do banco de dados plugável.
   Ativar o acesso do ASM para o leitor binário	Marque esta caixa de seleção se você armazena seus registros do Oracle no Gerenciamento automático de armazenamento (ASM). Essa caixa de seleção se aplica apenas ao método CDC do leitor de registros binários (pré-lançamento). Se você selecionar essa opção, preencha os detalhes de conexão da instância do ASM, incluindo o nome do serviço do ASM. A conta de usuário da conexão do ASM precisa ter o privilégio SYSASM. Para mais informações sobre os métodos de CDC disponíveis, consulte Trabalhar com arquivos de registro de redo log do banco de dados Oracle.

5. Também é possível usar rótulos para organizar os recursos do Datastream.

   1. Para criar um rótulo, clique em ADICIONAR MARCADOR e insira o par de chave-valor.
   2. Para remover o rótulo, clique no ícone da lixeira à direita da linha que contém esse rótulo.

6. Na seção Definir configurações de conexão, clique em CONTINUAR. A página Proteger a conexão com a origem está ativa.

7. No menu Tipo de criptografia, selecione uma das seguintes opções:

   Tipo de criptografia	Descrição
   Nenhum	O Datastream se conecta ao banco de dados de origem sem criptografia.
   Somente servidor	Quando o Datastream se conecta ao banco de dados de origem, ele autentica a fonte, garantindo a conexão segura com o host correto. Isso evita ataques de pessoa no meio. Para autenticação somente de servidor, a origem não autentica o Datastream. Para usar a autenticação somente de servidor, você precisa fornecer o certificado x509 codificado por PEM da autoridade de certificação (CA) que assinou o certificado de origem. Use um único certificado, porque o Datastream não é compatível com cadeias de certificados.

8. Na seção Secure your connection to your source, clique em CONTINUAR. A seção Definir método de conectividade da página Criar perfil da Oracle está ativa.

9. No menu suspenso Método de conectividade, selecione um método de conectividade de rede. Esse método define como o Datastream se conecta ao banco de dados de origem. Os métodos de conectividade de rede atuais incluem:

   1. Lista de permissões de IP: esse método funciona configurando o servidor de banco de dados de origem para aceitar conexões do Datastream. Se você selecionar esse método de conectividade de rede, configure seu banco de dados de origem para permitir conexões de entrada dos endereços IP públicos do Datastream para a região especificada no perfil de conexão.
   2. Túnel SSH encaminhado: este método estabelece conectividade segura e criptografada entre o Datastream e o banco de dados de origem usando um túnel SSH para um servidor de túnel ou de servidor. Se você selecionar esse método de conectividade de rede, faça o seguinte:
      1. Digite o nome do host ou o endereço IP e a porta do servidor de host do túnel.
      2. Digite o nome de usuário da conta para o servidor de host do túnel.
      3. Selecione o método de autenticação para o túnel SSH. Se você selecionar Senha como o método, digite a senha da conta da VM do Bastion Host. Se você selecionar Par de chaves privadas/públicas como método, forneça uma chave privada.
      4. Configure o host do túnel para permitir conexões de entrada dos endereços IP públicos do Datastream para a região que você especificou para o perfil de conexão.

   3. Conectividade privada: esse método permite estabelecer uma conectividade segura entre o Datastream e o banco de dados de origem, internamente no Google Cloudou com fontes externas conectadas por VPN ou Interconnect. Essa comunicação acontece por uma interface do Private Service Connect ou uma conexão de peering de VPC.

      Se você selecionar esse método de conectividade de rede e tiver criado uma configuração de conectividade particular, selecione-a na lista de configurações. Esse tipo de configuração contém informações que o Datastream usa para se comunicar com o banco de dados de origem em uma rede privada.

      Se você não tiver criado uma configuração de conectividade particular, clique em CRIAR CONFIGURAÇÃO DE CONECTIVIDADE PARTICULAR na parte inferior da lista suspensa. Depois siga as mesmas etapas de Criar uma configuração conectividade particular.

      Observação :é possível usar a conectividade particular para conectar o Datastream a qualquer origem compatível. No entanto, quando você usa o peering de VPC, o peering transitivo não é compatível. Se a rede com que o Datastream está em peering não for a rede em que sua origem está hospedada, você estiver usando um banco de dados totalmente gerenciado (por exemplo, o Cloud SQL) ou se o Datastream não for executado na região em que sua origem existe, uma VM NAT será necessária.
      
      Para mais informações, consulte Peering de VPC.

10. Na seção Definir método de conectividade, clique em CONTINUAR. A seção Testar perfil de conexão da página Criar perfil da Oracle está ativa.

11. Clique em EXECUTAR TESTE para verificar se o Datastream pode se comunicar com a origem.

    Se o teste falhar, isso indicará que parte do processo teve um problema. Consulte a página Diagnosticar problemas para ver as etapas de solução de problemas. Faça as mudanças necessárias e teste novamente na página Criar perfil do Oracle.

    Navegue até a parte do fluxo em questão para corrigir o problema e teste novamente.

    Observação: o perfil de conexão pode ser criado mesmo se o teste falhar, mas você precisa corrigir todos os problemas associados ao perfil de conexão antes de usá-lo em um stream.

12. Clique em CRIAR.

Criar um perfil de conexão para banco de dados MySQL

1. Acesse a página Perfis de conexão no console do Google Cloud .

   Acessar a página "Perfis de conexão"

2. Clique em CRIAR PERFIL.

3. Na página Criar um perfil de conexão, clique no tipo de perfil MySQL.

4. Use a tabela a seguir para preencher os campos da seção Definir configurações de conexão da página Criar perfil do MySQL:

   Campo	Descrição
   Nome do perfil de conexão	Digite o nome de exibição do perfil de conexão com o banco de dados MySQL de origem. É usado na lista de perfis de conexão e também quando um perfil de conexão existente é selecionado na criação de um stream.
   ID do perfil de conexão	O Datastream preenche esse campo automaticamente com base no nome do perfil de conexão inserido. É possível manter o ID gerado automaticamente ou alterá-lo.
   Região	Selecione a região em que o perfil de conexão é armazenado. Os perfis de conexão, assim como todos os recursos, são salvos em uma região, e um stream só pode usar perfis de conexão armazenados na mesma região do stream. A seleção de região não afeta a capacidade do Datastream de se conectar à origem ou ao destino, mas pode afetar a disponibilidade se a região tiver um período de inatividade.
   IP ou nome do host	Insira um nome do host ou endereço IP que o Datastream possa usar para se conectar ao banco de dados MySQL de origem. Se você estiver usando conectividade privada para se comunicar com o banco de dados de origem, especifique o endereço IP particular (interno) do banco de dados de origem. Se você estiver usando um proxy reverso para conectividade privada, use o endereço IP do proxy. Para outros métodos de conectividade, como inclusão de lista de permissão de IP ou SSH em encaminhamento, informe o endereço IP público.
   Porta	Digite o número reservado para o banco de dados de origem (a porta padrão geralmente é 3306).
   Username	Digite o nome de usuário da conta para o banco de dados de origem (por exemplo, root). Esse é o usuário do Datastream que você criou para o banco de dados. Para mais informações sobre como criar esse usuário, consulte Configurar um banco de dados MySQL de origem.
   Selecionar a senha do Secret Manager	Selecione esta opção se quiser autenticar com um secret em vez de inserir a senha manualmente. Ao selecionar essa opção, dois menus suspensos aparecem: Secret: selecione um secret na lista (se disponível), insira-o manualmente ou crie um novo secret: Para inserir um secret manualmente: Clique em Inserir secret manualmente. A caixa de diálogo Adicionar um secret por ID do recurso é exibida. Copie e cole o identificador do recurso do secret do Secret Manager. O ID do recurso do secret pode ter o seguinte formato: projects/PROJECT_NUMBER/secrets/SECRET_NAME (versão mais recente) projects/PROJECT_NUMBER/secrets/SECRET_NAME/versions/VERSION_NUMBER (versão específica) Clique em Adicionar secret. Para criar um secret: Clique em Criar novo secret. O painel lateral Detalhes do secret é aberto. Em Nome, insira um nome para o secret (por exemplo, my-secret). O nome do secret pode conter letras maiúsculas e minúsculas, numerais, hifens e sublinhados. O comprimento máximo permitido para um nome é de 255 caracteres. O nome que você criar será adicionado como parte do identificador do recurso do secret. Opcional: para adicionar uma versão do secret ao criar o secret inicial, no campo Valor do secret, digite um valor (por exemplo, abcd1234). O valor do secret pode estar em qualquer formato, mas não pode ultrapassar 64 KiB. Também é possível fazer upload de um arquivo de texto com o valor do secret usando a opção Fazer upload do arquivo. Clique no botão Criar secret. Versão do secret: insira a versão do secret que você quer usar: Quando você fornece o identificador de recurso do secret, a caixa de seleção Usar a versão mais recente aparece. Selecione essa opção para usar a versão mais atualizada do recurso de secret. Como alternativa, você pode expandir o menu suspenso Versão do secret e selecionar a versão na lista, se disponível. Se você quiser usar uma versão diferente do secret, siga estas etapas: Clique em Adicionar nova versão. No campo Valor do secret, insira um valor para o secret. Como alternativa, é possível fazer upload de um arquivo que contenha o valor do secret. Clique no botão Adicionar nova versão.
   Inserir senha manualmente	Como alternativa, é possível inserir manualmente a senha da conta do banco de dados de origem.

5. Também é possível usar rótulos para organizar os recursos do Datastream.

   1. Para criar um rótulo, clique em ADICIONAR MARCADOR e insira o par de chave-valor.
   2. Para remover o rótulo, clique no ícone da lixeira à direita da linha que contém esse rótulo.

6. Na seção Definir configurações de conexão, clique em CONTINUAR. A página Proteger a conexão com a origem está ativa.

7. No menu Tipo de criptografia, selecione uma das seguintes opções:

   Tipo de criptografia	Descrição
   Nenhum	O Datastream se conecta ao banco de dados de origem sem criptografia.
   Somente servidor	Quando o Datastream se conecta ao banco de dados de origem, ele autentica a fonte, garantindo a conexão segura com o host correto. Isso evita ataques de pessoa no meio. Para autenticação somente de servidor, a origem não autentica o Datastream. Para usar a autenticação somente de servidor, você precisa fornecer o certificado x509 codificado por PEM da autoridade de certificação (CA) que assinou o certificado de origem. Use um único certificado, porque o Datastream não é compatível com cadeias de certificados. Para mais informações sobre como criar certificados e chaves para seu servidor de banco de dados, consulte Como criar certificados e chaves SSL e RSA.
   Cliente-servidor	Quando o Datastream se conecta à origem, o Datastream autentica a fonte, e a fonte autentica o Datastream. A autenticação cliente-servidor proporciona a segurança mais forte. No entanto, se você não quiser fornecer o certificado de cliente e a chave privada ao criar o perfil de conexão, poderá usar a autenticação somente de servidor. Para usar a autenticação servidor-cliente, é necessário informar os seguintes itens ao criar o perfil de conexão de origem: O certificado da autoridade de certificação que assinou o certificado do servidor de banco de dados de origem (o certificado da CA). O certificado usado pela instância para autenticação no servidor de banco de dados de origem (o certificado do cliente) A chave privada associada ao certificado do cliente (a chave do cliente). Para mais informações sobre como criar certificados e chaves para seu servidor de banco de dados, consulte Como criar certificados e chaves SSL e RSA.

8. Na seção Secure your connection to your source, clique em CONTINUAR. A seção Definir método de conectividade da página Criar perfil do MySQL está ativa.

9. No menu suspenso Método de conectividade, selecione um método de conectividade de rede. Esse método define como o Datastream se conecta ao banco de dados de origem. Os métodos de conectividade de rede atuais incluem:

   1. Lista de permissões de IP: esse método funciona configurando o servidor de banco de dados de origem para aceitar conexões do Datastream. Se você selecionar esse método de conectividade de rede, configure seu banco de dados de origem para permitir conexões de entrada dos endereços IP públicos do Datastream para a região especificada no perfil de conexão.
   2. Túnel SSH encaminhado: este método estabelece conectividade segura e criptografada entre o Datastream e o banco de dados de origem usando um túnel SSH para um servidor de túnel ou de servidor. Se você selecionar esse método de conectividade de rede, faça o seguinte:
      1. Digite o nome do host ou o endereço IP e a porta do servidor de host do túnel.
      2. Digite o nome de usuário da conta para o servidor de host do túnel.
      3. Selecione o método de autenticação para o túnel SSH. Se você selecionar Senha como o método, digite a senha da conta da VM do Bastion Host. Se você selecionar Par de chaves privadas/públicas como método, forneça uma chave privada.
      4. Configure o host do túnel para permitir conexões de entrada dos endereços IP públicos do Datastream para a região que você especificou para o perfil de conexão.

   3. Conectividade privada: esse método permite estabelecer uma conectividade segura entre o Datastream e o banco de dados de origem, internamente no Google Cloudou com fontes externas conectadas por VPN ou Interconnect. Essa comunicação acontece por uma interface do Private Service Connect ou uma conexão de peering de VPC.

      Se você selecionar esse método de conectividade de rede e tiver criado uma configuração de conectividade particular, selecione-a na lista de configurações. Esse tipo de configuração contém informações que o Datastream usa para se comunicar com o banco de dados de origem em uma rede privada.

      Se você não tiver criado uma configuração de conectividade particular, clique em CRIAR CONFIGURAÇÃO DE CONECTIVIDADE PARTICULAR na parte inferior da lista suspensa. Depois siga as mesmas etapas de Criar uma configuração conectividade particular.

      Observação :é possível usar a conectividade particular para conectar o Datastream a qualquer origem compatível. No entanto, quando você usa o peering de VPC, o peering transitivo não é compatível. Se a rede com que o Datastream está em peering não for a rede em que sua origem está hospedada, você estiver usando um banco de dados totalmente gerenciado (por exemplo, o Cloud SQL) ou se o Datastream não for executado na região em que sua origem existe, uma VM NAT será necessária.
      
      Para mais informações, consulte Peering de VPC.

10. Na seção Definir método de conectividade, clique em CONTINUAR. A seção Testar perfil de conexão da página Criar perfil do MySQL está ativa.

11. Clique em EXECUTAR TESTE para verificar se o Datastream pode se comunicar com a origem.

    Se o teste falhar, isso indicará que parte do processo teve um problema. Consulte a página Diagnosticar problemas para ver as etapas de solução de problemas. Faça as alterações necessárias e teste o perfil de conexão novamente.

    Navegue até a parte do fluxo em questão para corrigir o problema e teste novamente.

    Observação: o perfil de conexão pode ser criado mesmo se o teste falhar, mas você precisa corrigir todos os problemas associados ao perfil de conexão antes de usá-lo em um stream.

12. Clique em CRIAR.

Criar um perfil de conexão para o banco de dados PostgreSQL

1. Acesse a página Perfis de conexão no console do Google Cloud .

   Acessar a página "Perfis de conexão"

2. Clique em CRIAR PERFIL.

3. Na página Criar um perfil de conexão, clique no tipo de perfil PostgreSQL.

4. Use a tabela a seguir para preencher os campos da seção Definir configurações de conexão da página Criar perfil do PostgreSQL:

   Campo	Descrição
   Nome do perfil de conexão	Insira o nome de exibição do perfil de conexão com o banco de dados PostgreSQL de origem. É usado na lista de perfis de conexão e também quando um perfil de conexão existente é selecionado na criação de um stream.
   ID do perfil de conexão	O Datastream preenche esse campo automaticamente com base no nome do perfil de conexão inserido. É possível manter o ID gerado automaticamente ou alterá-lo.
   Região	Selecione a região em que o perfil de conexão é armazenado. Os perfis de conexão, assim como todos os recursos, são salvos em uma região, e um stream só pode usar perfis de conexão armazenados na mesma região do stream. A seleção de região não afeta a capacidade do Datastream de se conectar à origem ou ao destino, mas pode afetar a disponibilidade se a região tiver um período de inatividade.
   IP ou nome do host	Insira um nome do host ou endereço IP que o Datastream possa usar para se conectar ao banco de dados PostgreSQL de origem. Se você estiver usando conectividade privada para se comunicar com o banco de dados de origem, especifique o endereço IP particular (interno) do banco de dados de origem. Se você estiver usando um proxy reverso para conectividade privada, use o endereço IP do proxy. Para outros métodos de conectividade, como inclusão de lista de permissão de IP ou SSH em encaminhamento, informe o endereço IP público.
   Porta	Insira o número da porta reservada para o banco de dados de origem. A porta padrão do PostgreSQL geralmente é 5432.
   Nome de usuário	Digite o nome de usuário da conta para o banco de dados de origem (por exemplo, root). Esse é o usuário do Datastream que você criou para o banco de dados. Para mais informações sobre como criar esse usuário, consulte Configurar o banco de dados PostgreSQL de origem.
   Selecionar a senha do Secret Manager	Selecione esta opção se quiser autenticar com um secret em vez de inserir a senha manualmente. Ao selecionar essa opção, dois menus suspensos aparecem: Secret: selecione um secret na lista (se disponível), insira-o manualmente ou crie um novo secret: Para inserir um secret manualmente: Clique em Inserir secret manualmente. A caixa de diálogo Adicionar um secret por ID do recurso é exibida. Copie e cole o identificador do recurso do secret do Secret Manager. O ID do recurso do secret pode ter o seguinte formato: projects/PROJECT_NUMBER/secrets/SECRET_NAME (versão mais recente) projects/PROJECT_NUMBER/secrets/SECRET_NAME/versions/VERSION_NUMBER (versão específica) Clique no botão Adicionar secret. Para criar um secret: Clique em Criar secret. O painel lateral Detalhes do secret é aberto. Em Nome, insira um nome para o secret (por exemplo, my-secret). O nome do secret pode conter letras maiúsculas e minúsculas, numerais, hifens e sublinhados. O comprimento máximo permitido para um nome é de 255 caracteres. O nome que você criar será adicionado como parte do identificador do recurso do secret. Opcional: para adicionar uma versão do secret ao criar o secret inicial, no campo Valor do secret, digite um valor (por exemplo, abcd1234). O valor do secret pode estar em qualquer formato, mas não pode ultrapassar 64 KiB. Também é possível fazer upload de um arquivo de texto com o valor do secret usando a opção Fazer upload do arquivo. Clique no botão Criar secret. Versão do secret: insira a versão do secret que você quer usar: Quando você fornece o identificador de recurso do secret, a caixa de seleção Usar a versão mais recente aparece. Selecione essa opção para usar a versão mais atualizada do recurso de secret. Como alternativa, você pode expandir o menu suspenso Versão do secret e selecionar a versão na lista, se disponível. Se você quiser usar uma versão diferente do secret, siga estas etapas: Clique em Adicionar nova versão. No campo Valor do secret, insira um valor para o secret. Como alternativa, é possível fazer upload de um arquivo que contenha o valor do secret. Clique no botão Adicionar nova versão.
   Inserir senha manualmente	Como alternativa, é possível inserir manualmente a senha da conta do banco de dados de origem.
   Banco de dados	Insira o nome que identifica a instância do banco de dados. Para bancos de dados PostgreSQL, geralmente é postgres.

5. Também é possível usar rótulos para organizar os recursos do Datastream.

   1. Para criar um rótulo, clique em ADICIONAR MARCADOR e insira o par de chave-valor.
   2. Para remover o rótulo, clique no ícone da lixeira à direita da linha que contém esse rótulo.

6. Clique em CONTINUAR. A página Proteger a conexão com sua origem está ativa.

7. No menu Tipo de criptografia, selecione uma das seguintes opções:

   Tipo de criptografia	Descrição
   Nenhum	O Datastream se conecta ao banco de dados de origem sem criptografia.
   Somente servidor	Quando o Datastream se conecta ao banco de dados de origem, ele autentica a fonte, garantindo a conexão segura com o host correto. Isso evita ataques de pessoa no meio. Para autenticação somente de servidor, a origem não autentica o Datastream. Para usar a autenticação somente de servidor, você precisa fornecer o certificado x509 codificado por PEM da autoridade de certificação (CA) que assinou o certificado de origem. Use um único certificado, porque o Datastream não é compatível com cadeias de certificados.
   Cliente-servidor	Quando o Datastream se conecta à origem, o Datastream autentica a fonte, e a fonte autentica o Datastream. A autenticação cliente-servidor proporciona a segurança mais forte. No entanto, se você não quiser fornecer o certificado de cliente e a chave privada ao criar o perfil de conexão, poderá usar a autenticação somente de servidor. Para usar a autenticação servidor-cliente, é necessário informar os seguintes itens ao criar o perfil de conexão de origem: O certificado da autoridade de certificação que assinou o certificado do servidor de banco de dados de origem (o certificado da CA). O certificado usado pela instância para autenticação no servidor de banco de dados de origem (o certificado do cliente) A chave privada associada ao certificado do cliente (a chave do cliente).

8. Clique em CONTINUAR. A seção Definir método de conectividade da página Criar perfil do PostgreSQL está ativa.

9. No menu suspenso Método de conectividade, selecione um método de conectividade de rede. Esse método define como o Datastream se conecta ao banco de dados de origem. Os métodos de conectividade de rede atuais incluem:

   1. Lista de permissões de IP: esse método funciona configurando o servidor do banco de dados de origem para aceitar conexões do Datastream. Se você selecionar esse método de conectividade de rede, configure seu banco de dados de origem para permitir conexões de entrada dos endereços IP públicos do Datastream para a região especificada no perfil de conexão.
   2. Túnel SSH de encaminhamento: esse método estabelece uma conectividade segura e criptografada entre o Datastream e o banco de dados de origem, usando um túnel SSH para um servidor de túnel ou para o servidor de banco de dados. Se você selecionar esse método de conectividade de rede, faça o seguinte:
      1. Digite o nome do host ou o endereço IP e a porta do servidor de host do túnel.
      2. Digite o nome de usuário da conta para o servidor de host do túnel.
      3. Selecione o método de autenticação para o túnel SSH. Se você selecionar Senha como o método, digite a senha da conta da VM do Bastion Host. Se você selecionar Par de chaves privadas/públicas como método, forneça uma chave privada.
      4. Configure o host do túnel para permitir conexões de entrada dos endereços IP públicos do Datastream para a região que você especificou para o perfil de conexão.

   3. Conectividade privada: esse método permite estabelecer uma conectividade segura entre o Datastream e o banco de dados de origem, internamente no Google Cloudou com fontes externas conectadas por VPN ou Interconnect. Essa comunicação acontece por uma interface do Private Service Connect ou uma conexão de peering de VPC.

      Se você selecionar esse método de conectividade de rede e tiver criado uma configuração de conectividade particular, selecione-a na lista de configurações. Esse tipo de configuração contém informações que o Datastream usa para se comunicar com o banco de dados de origem em uma rede privada.

      Se você não tiver criado uma configuração de conectividade particular, clique em CRIAR CONFIGURAÇÃO DE CONECTIVIDADE PARTICULAR na parte inferior da lista suspensa. Depois siga as mesmas etapas de Criar uma configuração conectividade particular.

      Observação :é possível usar a conectividade particular para conectar o Datastream a qualquer origem compatível. No entanto, quando você usa o peering de VPC, o peering transitivo não é compatível. Se a rede com que o Datastream está em peering não for a rede em que sua origem está hospedada, você estiver usando um banco de dados totalmente gerenciado (por exemplo, o Cloud SQL) ou se o Datastream não for executado na região em que sua origem existe, uma VM NAT será necessária.
      
      Para mais informações, consulte Peering de VPC.

10. Na seção Definir método de conectividade, clique em CONTINUAR. A seção Testar perfil de conexão da página Criar perfil do PostgreSQL está ativa.

11. Clique em EXECUTAR TESTE para verificar se o Datastream pode se comunicar com a origem.

    Se o teste falhar, isso indicará que parte do processo teve um problema. Consulte a página Diagnosticar problemas para ver as etapas de solução de problemas. Faça as alterações necessárias e teste o perfil de conexão novamente.

    Navegue até a parte do fluxo em questão para corrigir o problema e teste novamente.

    Observação: o perfil de conexão pode ser criado mesmo se o teste falhar, mas você precisa corrigir todos os problemas associados ao perfil de conexão antes de usá-lo em um stream.

12. Clique em CRIAR.

Criar um perfil de conexão para o banco de dados do SQL Server

1. Acesse a página Perfis de conexão no console do Google Cloud .

   Acessar a página "Perfis de conexão"

2. Clique em CRIAR PERFIL.

3. Na página Criar um perfil de conexão, clique no tipo de perfil SQL Server.

4. Use a tabela a seguir para preencher os campos da seção Definir configurações de conexão da página Criar perfil do SQL Server:

   Campo	Descrição
   Nome do perfil de conexão	Insira o nome de exibição do perfil de conexão com o banco de dados de origem do SQL Server. É usado na lista de perfis de conexão e também quando um perfil de conexão existente é selecionado na criação de um stream.
   ID do perfil de conexão	O Datastream preenche esse campo automaticamente com base no nome do perfil de conexão inserido. É possível manter o ID gerado automaticamente ou alterá-lo.
   Região	Selecione a região em que o perfil de conexão é armazenado. Os perfis de conexão, assim como todos os recursos, são salvos em uma região, e um stream só pode usar perfis de conexão armazenados na mesma região do stream. A seleção de região não afeta a capacidade do Datastream de se conectar à origem ou ao destino, mas pode afetar a disponibilidade se a região tiver um período de inatividade.
   IP ou nome do host	Insira um nome do host ou endereço IP que o Datastream possa usar para se conectar ao banco de dados de origem do SQL Server. Se você estiver usando conectividade privada para se comunicar com o banco de dados de origem, especifique o endereço IP particular (interno) do banco de dados de origem. Para a lista de permissões de IP, forneça o endereço IP público. Se você estiver usando um proxy reverso para conectividade privada, use o endereço IP do proxy.
   Porta	Insira o número da porta reservado para o banco de dados de origem. A porta padrão geralmente é 1433.
   Nome de usuário	Digite o nome de usuário da conta para o banco de dados de origem (por exemplo, root). Esse é o usuário do Datastream que você criou para o banco de dados. Para bancos de dados SQL do Azure, talvez seja necessário inserir o nome de usuário completo, junto com o nome de domínio. Para mais informações sobre como criar esse usuário, consulte Configurar o banco de dados de origem do SQL Server.
   Selecionar a senha do Secret Manager	Selecione esta opção se quiser autenticar com um secret em vez de inserir a senha manualmente. Ao selecionar essa opção, dois menus suspensos aparecem: Secret: selecione um secret na lista (se disponível), insira-o manualmente ou crie um novo secret: Para inserir um secret manualmente: Clique em Inserir secret manualmente. A caixa de diálogo Adicionar um secret por ID do recurso é exibida. Copie e cole o identificador do recurso do secret do Secret Manager. O ID do recurso do secret pode ter o seguinte formato: projects/PROJECT_NUMBER/secrets/SECRET_NAME (versão mais recente) projects/PROJECT_NUMBER/secrets/SECRET_NAME/versions/VERSION_NUMBER (versão específica) Clique no botão Adicionar secret. Para criar um secret: Clique em Criar secret. O painel lateral Detalhes do secret é aberto. Em Nome, insira um nome para o secret (por exemplo, my-secret). O nome do secret pode conter letras maiúsculas e minúsculas, numerais, hifens e sublinhados. O comprimento máximo permitido para um nome é de 255 caracteres. O nome que você criar será adicionado como parte do identificador do recurso do secret. Opcional: para adicionar uma versão do secret ao criar o secret inicial, no campo Valor do secret, digite um valor (por exemplo, abcd1234). O valor do secret pode estar em qualquer formato, mas não pode ultrapassar 64 KiB. Também é possível fazer upload de um arquivo de texto com o valor do secret usando a opção Fazer upload do arquivo. Clique no botão Criar secret. Versão do secret: insira a versão do secret que você quer usar: Quando você fornece o identificador de recurso do secret, a caixa de seleção Usar a versão mais recente aparece. Selecione essa opção para usar a versão mais atualizada do recurso de secret. Como alternativa, você pode expandir o menu suspenso Versão do secret e selecionar a versão na lista, se disponível. Se você quiser usar uma versão diferente do secret, siga estas etapas: Clique em Adicionar nova versão. No campo Valor do secret, insira um valor para o secret. Como alternativa, é possível fazer upload de um arquivo que contenha o valor do secret. Clique no botão Adicionar nova versão.
   Inserir senha manualmente	Como alternativa, é possível inserir manualmente a senha da conta do banco de dados de origem.
   Banco de dados	Insira o nome que identifica a instância do banco de dados.

5. Também é possível usar rótulos para organizar os recursos do Datastream.

   1. Para criar um rótulo, clique em ADICIONAR MARCADOR e insira o par de chave-valor.
   2. Para remover o rótulo, clique no ícone da lixeira à direita da linha que contém esse rótulo.

6. Clique em Continuar.

7. Na seção Definir método de conectividade, no menu suspenso Método de conectividade, selecione um método de conectividade de rede. Esse método define como o Datastream se conecta ao banco de dados de origem. Os métodos de conectividade de rede incluem:

   1. Lista de permissões de IP: esse método funciona configurando o servidor do banco de dados de origem para aceitar conexões do Datastream. Se você selecionar esse método de conectividade de rede, configure seu banco de dados de origem para permitir conexões de entrada dos endereços IP públicos do Datastream para a região especificada no perfil de conexão.
   2. Túnel SSH de encaminhamento: esse método cria uma conexão segura e criptografada entre o banco de dados de origem e o Datastream. Para configurar esse método de conectividade, é necessário ter um servidor SSH com acesso ao banco de dados de origem. Se você selecionar esse método de conectividade de rede:
      1. Insira o nome do host ou o endereço IP e a porta do servidor host do túnel.
      2. Digite o nome de usuário da conta para o servidor de host do túnel.
      3. Selecione o método de autenticação para o túnel SSH. Se você selecionar Par de chaves privada/pública como o método, forneça uma chave privada. Se você selecionar Senha como o método, insira a senha da conta da VM do Bastion Host.
      4. Também pode ser necessário incluir os endereços IP externo do Datastream na lista de permissões do servidor do túnel SSH.

   3. Conectividade privada: esse método permite estabelecer uma conectividade segura entre o Datastream e o banco de dados de origem, internamente no Google Cloudou com fontes externas conectadas por VPN ou Interconnect. Essa comunicação acontece por uma interface do Private Service Connect ou uma conexão de peering de VPC.

      Se você selecionar esse método de conectividade de rede e tiver criado uma configuração de conectividade particular, selecione-a na lista de configurações. Esse tipo de configuração contém informações que o Datastream usa para se comunicar com o banco de dados de origem em uma rede privada.

      Se você não tiver criado uma configuração de conectividade particular, clique em CRIAR CONFIGURAÇÃO DE CONECTIVIDADE PARTICULAR na parte inferior da lista suspensa. Depois siga as mesmas etapas de Criar uma configuração conectividade particular.

      Observação :é possível usar a conectividade particular para conectar o Datastream a qualquer origem compatível. No entanto, quando você usa o peering de VPC, o peering transitivo não é compatível. Se a rede com que o Datastream está em peering não for a rede em que sua origem está hospedada, você estiver usando um banco de dados totalmente gerenciado (por exemplo, o Cloud SQL) ou se o Datastream não for executado na região em que sua origem existe, uma VM NAT será necessária.
      
      Para mais informações, consulte Peering de VPC.

8. Clique em CONTINUAR. A seção Testar perfil de conexão da página Criar perfil do SQL Server está ativa.

9. Clique em EXECUTAR TESTE para verificar se o Datastream pode se comunicar com a origem.

   Se o teste falhar, isso indicará que parte do processo teve um problema. Consulte a página Diagnosticar problemas para ver as etapas de solução de problemas. Faça as alterações necessárias e teste o perfil de conexão novamente.

   Navegue até a parte do fluxo em questão para corrigir o problema e teste novamente.

   Observação: o perfil de conexão pode ser criado mesmo se o teste falhar, mas você precisa corrigir todos os problemas associados ao perfil de conexão antes de usá-lo em um stream.

10. Clique em CRIAR.

Criar um perfil de conexão para uma organização do Salesforce

1. Acesse a página Perfis de conexão no console do Google Cloud .

   Acessar a página "Perfis de conexão"

2. Clique em CRIAR PERFIL.

3. Na página Criar um perfil de conexão, clique no tipo de perfil Salesforce.

4. Use a tabela a seguir para preencher os campos da seção Definir configurações de conexão da página Criar perfil do Salesforce:

   Campo	Descrição
   Nome do perfil de conexão	Insira o nome de exibição do perfil de conexão com a organização de origem do Salesforce. É usado na lista de perfis de conexão e também quando um perfil de conexão existente é selecionado na criação de um stream.
   ID do perfil de conexão	O Datastream preenche esse campo automaticamente com base no nome do perfil de conexão inserido. É possível manter o ID gerado automaticamente ou alterá-lo.
   Região	Selecione a região em que o perfil de conexão é armazenado. Os perfis de conexão, assim como todos os recursos, são salvos em uma região, e um stream só pode usar perfis de conexão armazenados na mesma região do stream. A seleção de região não afeta a capacidade do Datastream de se conectar à origem ou ao destino, mas pode afetar a disponibilidade se a região tiver um período de inatividade.

5. Na seção Detalhes da conexão, insira o endereço de URL do seu domínio do Salesforce. Para encontrar o URL do seu domínio, acesse o Salesforce e clique em Configuração > Configurações da empresa > Meu domínio. O URL está em Detalhes do meu domínio. Normalmente, ele tem o seguinte formato: domain-name.my.salesforce.com.

6. Em Método de autenticação, selecione o método de autenticação:

   • Autenticação de credenciais do cliente OAuth 2.0: se você selecionar essa opção, será necessário indicar o identificador e a chave secreta do cliente. Para a chave secreta do cliente, forneça o ID e a versão do recurso secreto do Secret Manager, por exemplo, projects/my-project/locations/us-central1/secrets/salesforce-secret/versions/1, ou insira o valor bruto do secret.

     Para mais informações sobre como conseguir o ID do cliente e a chave secreta do cliente, consulte Configurar uma organização de origem do Salesforce.

   • Autenticação de nome de usuário/senha: se você selecionar essa opção, precisará inserir o nome de usuário e a senha da sua conta do Salesforce.

     • Em "Nome de usuário", digite o nome que você usa para fazer login no Salesforce. Se você já tiver feito login na sua organização do Salesforce, abra a página de configurações da conta e clique em Informações pessoais para encontrar seu nome de usuário. O nome está em Nome de usuário.

     • Para a senha, forneça o ID e a versão do recurso do secret do Secret Manager, por exemplo, projects/my-project/locations/us-central1/secrets/salesforce-secret/versions/1, ou o valor bruto da senha.

       Na seção Token de segurança, informe o ID do recurso secreto do token e a versão do Secret Manager, por exemplo, projects/my-project/locations/us-central1/secrets/salesforce-secret/versions/1, ou insira o valor bruto do token de segurança, por exemplo, C08120F510542FFB1C3640F57AF19E2D5D700556A25F7D665C3B428407709D8C.

7. Também é possível usar rótulos para organizar os recursos do Datastream.

   1. Para criar um rótulo, clique em ADICIONAR MARCADOR e insira o par de chave-valor.
   2. Para remover o rótulo, clique no ícone da lixeira à direita da linha que contém esse rótulo.

8. Clique em Continuar.

9. Na seção Revisar método de conectividade, revise os endereços IP regionais do Datastream listados e verifique se você configurou sua organização do Salesforce para aceitar conexões de entrada desses endereços. Para mais informações sobre como configurar sua instância do Salesforce, consulte Configurar uma organização do Salesforce.

10. Clique em CONTINUAR. A seção Testar perfil de conexão da página Criar perfil do Salesforce está ativa.

11. Clique em EXECUTAR TESTE para verificar se o Datastream pode se comunicar com a origem.

    Se o teste falhar, isso indicará que parte do processo teve um problema. Consulte a página Diagnosticar problemas para ver as etapas de solução de problemas. Faça as alterações necessárias e teste o perfil de conexão novamente.

    Navegue até a parte do fluxo em questão para corrigir o problema e teste novamente.

    Observação: o perfil de conexão pode ser criado mesmo se o teste falhar, mas você precisa corrigir todos os problemas associados ao perfil de conexão antes de usá-lo em um stream.

12. Clique em CRIAR.

Criar um perfil de conexão para um ambiente do Dataverse

Visualizar

Este recurso está sujeito aos Termos das Soluções Pré-GA na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Os recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

1. Acesse a página Perfis de conexão no console do Google Cloud .

   Acessar a página "Perfis de conexão"

2. Clique em Criar perfil.

3. Na página Criar um perfil de conexão, clique no tipo de perfil Dataverse.

4. Use a tabela a seguir para preencher os campos da seção Definir configurações de conexão da página Criar perfil do Dataverse:

   Campo	Descrição
   Nome do perfil de conexão	Insira o nome de exibição do perfil de conexão com o Dataverse de origem. É usado na lista de perfis de conexão e também quando um perfil de conexão existente é selecionado na criação de um stream.
   ID do perfil de conexão	O Datastream preenche esse campo automaticamente com base no nome do perfil de conexão inserido. É possível manter o ID gerado automaticamente ou alterá-lo.
   Região	Selecione a região em que o perfil de conexão é armazenado. Os perfis de conexão, assim como todos os recursos, são salvos em uma região, e um stream só pode usar perfis de conexão armazenados na mesma região do stream. A seleção de região não afeta a capacidade do Datastream de se conectar à origem ou ao destino, mas pode afetar a disponibilidade se a região tiver um período de inatividade.
   URL do ambiente	Insira o URL do ambiente do Dataverse, por exemplo, myorg.crm4.dynamics.com.
   Código do locatário	Insira o identificador de locatário do Azure Active Directory associado ao seu ambiente do Dataverse. Identifica a instância do Azure AD usada para autenticação.
   ID do cliente	Insira o identificador do cliente do aplicativo do Azure AD registrado para se conectar ao Dataverse. Esse aplicativo precisa ser configurado com as permissões de API necessárias.
   Chave secreta do cliente	Insira a chave secreta ou o valor gerado para o aplicativo do Azure AD. Essa chave secreta é usada, junto com o ID do cliente, para autenticar o aplicativo e estabelecer a conexão.

5. Na seção Definir método de conectividade, clique em Continuar. A seção Testar perfil de conexão da página Criar perfil do Dataverse está ativa.

6. Clique em Executar teste para verificar se o Datastream pode se comunicar com a origem.

   Se o teste falhar, isso indicará que parte do processo teve um problema. Consulte a página Diagnosticar problemas para ver as etapas de solução de problemas. As mudanças necessárias podem ser feitas e testadas novamente na página Criar perfil do Dataverse.

   Navegue até a parte do fluxo em questão para corrigir o problema e teste novamente.

   Observação: o perfil de conexão pode ser criado mesmo se o teste falhar, mas você precisa corrigir todos os problemas associados ao perfil de conexão antes de usá-lo em um stream.

7. Clique em CRIAR.

Criar um perfil de conexão para uma instância do Salesforce Marketing Cloud

Visualizar

Este recurso está sujeito aos Termos das Soluções Pré-GA na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Os recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

1. Acesse a página Perfis de conexão no console do Google Cloud .

   Acessar a página "Perfis de conexão"

2. Clique em Criar perfil.

3. Na página Criar um perfil de conexão, clique no tipo de perfil Salesforce Marketing Cloud.

4. Use a tabela a seguir para preencher os campos da seção Definir configurações de conexão da página Criar perfil do Salesforce Marketing Cloud:

   Campo	Descrição
   Nome do perfil de conexão	Insira o nome de exibição do perfil de conexão com a instância de origem do Salesforce Marketing Cloud. É usado na lista de perfis de conexão e também quando um perfil de conexão existente é selecionado na criação de um stream.
   ID do perfil de conexão	O Datastream preenche esse campo automaticamente com base no nome do perfil de conexão inserido. É possível manter o ID gerado automaticamente ou alterá-lo.
   Região	Selecione a região em que o perfil de conexão é armazenado. Os perfis de conexão, assim como todos os recursos, são salvos em uma região, e um stream só pode usar perfis de conexão armazenados na mesma região do stream. A seleção de região não afeta a capacidade do Datastream de se conectar à origem ou ao destino, mas pode afetar a disponibilidade se a região tiver um período de inatividade.
   Subdomínio	Insira o subdomínio da sua instância do Salesforce Marketing Cloud. Para mais informações sobre como conseguir o nome do subdomínio, consulte Configurar uma instância do Salesforce Marketing Cloud.
   ID do cliente	Insira o ID do cliente da sua instância do Salesforce Marketing Cloud. Para mais informações sobre como conseguir o identificador do cliente, consulte Configurar uma instância do Salesforce Marketing Cloud.
   Chave secreta do cliente	Forneça o ID e a versão do recurso do secret do Secret Manager ou insira o valor bruto da chave secreta do cliente da sua instância do Salesforce Marketing Cloud.

5. Também é possível usar rótulos para organizar os recursos do Datastream.

   1. Para criar um rótulo, clique em ADICIONAR MARCADOR e insira o par de chave-valor.
   2. Para remover o rótulo, clique no ícone da lixeira à direita da linha que contém esse rótulo.

6. Clique em CONTINUAR. A seção Testar perfil de conexão da página Criar perfil do Salesforce Marketing Cloud está ativa.

7. Clique em EXECUTAR TESTE para verificar se o Datastream pode se comunicar com a origem.

   Se o teste falhar, isso indicará que parte do processo teve um problema. Consulte a página Diagnosticar problemas para ver as etapas de solução de problemas. Faça as alterações necessárias e teste o perfil de conexão novamente.

   Navegue até a parte do fluxo em questão para corrigir o problema e teste novamente.

   Observação: o perfil de conexão pode ser criado mesmo se o teste falhar, mas você precisa corrigir todos os problemas associados ao perfil de conexão antes de usá-lo em um stream.

8. Clique em CRIAR.

Criar um perfil de conexão para uma instância do ServiceNow

Visualizar

Este recurso está sujeito aos Termos das Soluções Pré-GA na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Os recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

1. Acesse a página Perfis de conexão no console do Google Cloud .

   Acessar a página "Perfis de conexão"

2. Clique em CRIAR PERFIL.

3. Na página Criar um perfil de conexão, clique no tipo de perfil ServiceNow.

4. Use a tabela a seguir para preencher os campos da seção Definir configurações de conexão da página Criar perfil do ServiceNow:

   Campo	Descrição
   Nome do perfil de conexão	Insira o nome de exibição do perfil de conexão com a instância de origem do ServiceNow. O Datastream usa esse nome na lista de perfis de conexão e quando você seleciona um perfil de conexão atual ao criar um stream.
   ID do perfil de conexão	O Datastream preenche esse campo automaticamente com base no nome do perfil de conexão inserido. É possível manter o ID gerado automaticamente ou alterá-lo.
   Região	Selecione a região em que você quer armazenar o perfil de conexão. Os perfis de conexão, assim como todos os recursos, são salvos em uma região, e um stream só pode usar perfis de conexão que residem na mesma região que ele.
   Instância	Insira o endereço de URL da sua instância do ServiceNow. Normalmente, ele tem o seguinte formato: company.service-now.com.
   Método de login	Selecione o método de autenticação: Credenciais do app conectado: se você selecionar essa opção, preencha o campo ID do cliente e a seção Chave secreta do cliente. Para a chave secreta do cliente, forneça o ID do recurso secreto e a versão do Secret Manager ou insira o valor bruto do secret. Credenciais do usuário: se você selecionar essa opção, precisará inserir o nome de usuário e a senha da sua conta do ServiceNow. Para a senha, forneça o ID e a versão do recurso do secret do Secret Manager ou o valor bruto da senha que você criou ao configurar o usuário de integração no ServiceNow. Para mais informações, consulte Configurar um usuário de integração.

5. Também é possível usar rótulos para organizar os recursos do Datastream.

   1. Para criar um rótulo, clique em ADICIONAR MARCADOR e insira o par de chave-valor.
   2. Para remover o rótulo, clique no ícone da lixeira à direita da linha que contém esse rótulo.

6. Clique em CONTINUAR.

7. Na seção Analisar método de conectividade, confira os endereços IP regionais do Datastream listados e verifique se você configurou sua instância do ServiceNow para aceitar conexões de entrada desses endereços. Para mais informações sobre como configurar sua instância do ServiceNow, consulte Configurar uma instância do ServiceNow.

8. Clique em CONTINUAR. A seção Testar perfil de conexão da página Criar perfil do ServiceNow está ativa.

9. Clique em EXECUTAR TESTE para verificar se o Datastream pode se comunicar com a origem.

10. Clique em CRIAR.

Criar um perfil de conexão para um banco de dados do MongoDB

1. Acesse a página Perfis de conexão no console do Google Cloud .

   Acessar a página "Perfis de conexão"

2. Clique em CRIAR PERFIL.

3. Na página Criar um perfil de conexão, clique no tipo de perfil MongoDB.

4. Na seção Definir configurações de conexão, especifique as seguintes informações:

   Campo	Descrição
   Nome do perfil de conexão	Insira o nome de exibição do perfil de conexão com o banco de dados de origem do MongoDB. É usado na lista de perfis de conexão e também quando um perfil de conexão existente é selecionado na criação de um stream.
   ID do perfil de conexão	O Datastream preenche esse campo automaticamente com base no nome do perfil de conexão inserido. É possível manter o ID gerado automaticamente ou alterá-lo.
   Região	Selecione a região em que o perfil de conexão é armazenado. Os perfis de conexão, assim como todos os recursos, são salvos em uma região, e um stream só pode usar perfis de conexão armazenados na mesma região do stream. A seleção de região não afeta a capacidade do Datastream de se conectar à origem ou ao destino, mas pode afetar a disponibilidade se a região tiver um período de inatividade.
   Formato da string de conexão	Especifique o formato que você quer usar para se conectar à origem do MongoDB: Formato de conexão SRV: uma string de conexão com um nome de host que corresponde a um registro SRV do serviço de nome de domínio (DNS). Para mais informações, consulte a documentação do MongoDB. Formato de string de conexão padrão: o formato padrão do URI de conexão do MongoDB usado para se conectar a uma implantação independente, um conjunto de réplicas ou um cluster fragmentado do MongoDB auto-hospedado. Para mais informações, consulte a documentação do MongoDB. Ao selecionar essa opção, você precisa selecionar uma das topologias do MongoDB compatíveis: Cluster fragmentado: um cluster fragmentado do MongoDB consiste em fragmentos, mongos e servidores de configuração. O MongoDB fragmenta dados no nível da coleção, distribuindo os dados da coleção entre os fragmentos no cluster. Conjunto de réplicas: um conjunto de réplicas no MongoDB é um grupo de processos mongod que mantêm o mesmo conjunto de dados. Os conjuntos de réplicas oferecem redundância e alta disponibilidade, além de serem a base de todas as implantações de produção. Ao selecionar essa opção, você precisa fornecer um nome de conjunto de réplicas.
   Nome do host	Insira um nome de host que o Datastream possa usar para se conectar ao banco de dados de origem do MongoDB. Se você estiver usando o formato de string de conexão padrão, poderá adicionar nomes de host de todas as máquinas no conjunto de réplicas. Se você estiver usando conectividade privada para se comunicar com o banco de dados de origem, especifique o endereço IP particular (interno) do banco de dados de origem. Se você estiver usando um proxy reverso para conectividade privada, use o endereço IP do proxy. Para outros métodos de conectividade, como lista de permissões de IP, informe o endereço IP público.
   Porta	Apenas para o formato padrão de string de conexão. Insira o número da porta reservado para o banco de dados de origem (a porta padrão do MongoDB geralmente é 27017). É possível adicionar portas de todas as máquinas no conjunto de réplicas ao usar o formato de conexão padrão.
   Nome de usuário	Digite o nome de usuário da conta para o banco de dados de origem (por exemplo, ROOT). Esse é o usuário do Datastream que você criou para o banco de dados. Para mais informações sobre como criar esse usuário, consulte Configurar o banco de dados de origem do MongoDB.
   Selecionar senha do Secret Manager	Selecione esta opção se quiser autenticar com um secret em vez de inserir a senha manualmente. Ao selecionar essa opção, dois menus suspensos aparecem: Secret: selecione um secret na lista (se disponível), insira-o manualmente ou crie um novo secret: Para inserir um secret manualmente: Clique em Inserir secret manualmente. A caixa de diálogo Adicionar um secret por ID do recurso é exibida. Copie e cole o identificador do recurso do secret do Secret Manager. O ID do recurso do secret pode ter o seguinte formato: projects/PROJECT_NUMBER/secrets/SECRET_NAME (versão mais recente) projects/PROJECT_NUMBER/secrets/SECRET_NAME/versions/VERSION_NUMBER (versão específica) Clique no botão Adicionar secret. Para criar um secret: Clique em Criar secret. O painel lateral Detalhes do secret é aberto. Em Nome, insira um nome para o secret (por exemplo, my-secret). O nome do secret pode conter letras maiúsculas e minúsculas, numerais, hifens e sublinhados. O comprimento máximo permitido para um nome é de 255 caracteres. O nome que você criar será adicionado como parte do identificador do recurso do secret. Opcional: para adicionar uma versão do secret ao criar o secret inicial, no campo Valor do secret, digite um valor (por exemplo, abcd1234). O valor do secret pode estar em qualquer formato, mas não pode ultrapassar 64 KiB. Também é possível fazer upload de um arquivo de texto com o valor do secret usando a opção Fazer upload do arquivo. Clique no botão Criar secret. Versão do secret: insira a versão do secret que você quer usar: Quando você fornece o identificador de recurso do secret, a caixa de seleção Usar a versão mais recente aparece. Selecione essa opção para usar a versão mais atualizada do recurso de secret. Como alternativa, você pode expandir o menu suspenso Versão do secret e selecionar a versão na lista, se disponível. Se você quiser usar uma versão diferente do secret, siga estas etapas: Clique em Adicionar nova versão. No campo Valor do secret, insira um valor para o secret. Como alternativa, é possível fazer upload de um arquivo que contenha o valor do secret. Clique no botão Adicionar nova versão.
   Inserir senha manualmente	Como alternativa, é possível inserir manualmente a senha da conta do banco de dados de origem.

5. Também é possível usar rótulos para organizar os recursos do Datastream.

   1. Para criar um rótulo, clique em ADICIONAR MARCADOR e insira o par de chave-valor.
   2. Para remover o rótulo, clique no ícone da lixeira à direita da linha que contém esse rótulo.

6. Clique em Continuar.

7. No menu Tipo de criptografia, selecione uma das seguintes opções:

   A autenticação cliente-servidor proporciona a segurança mais forte. No entanto, se você não quiser fornecer o certificado de cliente e a chave privada ao criar o perfil de conexão, poderá usar a autenticação somente de servidor.

   Para usar a autenticação servidor-cliente, é necessário informar os seguintes itens ao criar o perfil de conexão de origem:

   • O certificado da autoridade de certificação que assinou o certificado do servidor de banco de dados de origem (o certificado da CA).
   • O certificado usado pela instância para autenticação no servidor de banco de dados de origem (o certificado do cliente)
   • A chave privada associada ao certificado do cliente (a chave do cliente).

   Tipo de criptografia	Descrição
   Nenhum	O Datastream se conecta ao banco de dados de origem sem criptografia.
   Somente servidor	Quando o Datastream se conecta ao banco de dados de origem, ele autentica a fonte, garantindo a conexão segura com o host correto. Isso evita ataques de pessoa no meio. Para autenticação somente de servidor, a origem não autentica o Datastream. Para usar a autenticação somente de servidor, você precisa fornecer o certificado x509 codificado por PEM da autoridade de certificação (CA) que assinou o certificado de origem. Use um único certificado, porque o Datastream não é compatível com cadeias de certificados.
   Cliente-servidor	Quando o Datastream se conecta à origem, ele autentica a origem, e a origem autentica o Datastream.

8. Na seção Definir método de conectividade, no menu suspenso Método de conectividade, selecione um método de conectividade de rede. Esse método define como o Datastream se conecta ao banco de dados de origem. Os métodos de conectividade de rede incluem:

   1. Lista de permissões de IP: esse método funciona configurando o servidor do banco de dados de origem para aceitar conexões do Datastream. Se você selecionar esse método de conectividade de rede, configure seu banco de dados de origem para permitir conexões de entrada dos endereços IP públicos do Datastream para a região especificada no perfil de conexão.
   2. Túnel SSH de encaminhamento: esse método cria uma conexão segura e criptografada entre o banco de dados de origem e o Datastream. Para configurar esse método de conectividade, é necessário ter um servidor SSH com acesso ao banco de dados de origem. Se você selecionar esse método de conectividade de rede:
      1. Insira o nome do host ou o endereço IP do servidor SSH e a porta do servidor host do túnel.
      2. Digite o nome de usuário da conta para o servidor de host do túnel.
      3. Selecione o método de autenticação para o túnel SSH. Se você selecionar Par de chaves privada/pública como o método, forneça uma chave privada. Se você selecionar Senha como o método, insira a senha da conta da VM do Bastion Host.
      4. Também pode ser necessário incluir os endereços IP externo do Datastream na lista de permissões do servidor do túnel SSH.

   3. Conectividade privada: esse método permite estabelecer uma conectividade segura entre o Datastream e o banco de dados de origem, internamente no Google Cloudou com fontes externas conectadas por VPN ou Interconnect. Essa comunicação acontece por uma interface do Private Service Connect ou uma conexão de peering de VPC.

      Se você selecionar esse método de conectividade de rede e tiver criado uma configuração de conectividade particular, selecione-a na lista de configurações. Esse tipo de configuração contém informações que o Datastream usa para se comunicar com o banco de dados de origem em uma rede privada.

      Se você não tiver criado uma configuração de conectividade particular, clique em CRIAR CONFIGURAÇÃO DE CONECTIVIDADE PARTICULAR na parte inferior da lista suspensa. Depois siga as mesmas etapas de Criar uma configuração conectividade particular.

      Observação :é possível usar a conectividade particular para conectar o Datastream a qualquer origem compatível. No entanto, quando você usa o peering de VPC, o peering transitivo não é compatível. Se a rede com que o Datastream está em peering não for a rede em que sua origem está hospedada, você estiver usando um banco de dados totalmente gerenciado (por exemplo, o Cloud SQL) ou se o Datastream não for executado na região em que sua origem existe, uma VM NAT será necessária.
      
      Para mais informações, consulte Peering de VPC.

9. Clique em CONTINUAR. A seção Testar perfil de conexão da página Criar perfil do MongoDB está ativa.

10. Clique em EXECUTAR TESTE para verificar se o Datastream pode se comunicar com a origem.

    Se o teste falhar, isso indicará que parte do processo teve um problema. Consulte a página Diagnosticar problemas para ver as etapas de solução de problemas. Faça as alterações necessárias e teste o perfil de conexão novamente.

    Navegue até a parte do fluxo em questão para corrigir o problema e teste novamente.

    Observação: o perfil de conexão pode ser criado mesmo se o teste falhar, mas você precisa corrigir todos os problemas associados ao perfil de conexão antes de usá-lo em um stream.

11. Clique em CRIAR.

Criar um perfil de conexão para um banco de dados do Spanner

1. Acesse a página Perfis de conexão no console do Google Cloud .

   Acessar a página "Perfis de conexão"

2. Clique em CRIAR PERFIL.

3. Na página Criar um perfil de conexão, clique no tipo de perfil Spanner.

4. Use a tabela a seguir para preencher os campos da seção Definir configurações de conexão da página Criar perfil do Spanner:

   Campo	Descrição
   Nome do perfil de conexão	Insira o nome de exibição do perfil de conexão com o banco de dados de origem do Spanner.
   ID do perfil de conexão	O Datastream preenche esse campo automaticamente com base no nome do perfil de conexão inserido.
   Região	Selecione a região em que o perfil de conexão é armazenado.
   Banco de dados	Insira o caminho completo do banco de dados, incluindo as informações do projeto, da instância e do banco de dados. Ele precisa ter o seguinte formato: projects/PROJECT_ID/instances/INSTANCE_ID/databases/DATABASE_ID.

5. Também é possível usar rótulos para organizar os recursos do Datastream.

   1. Para criar um rótulo, clique em ADICIONAR MARCADOR e insira o par de chave-valor.
   2. Para remover o rótulo, clique no ícone da lixeira à direita da linha que contém esse rótulo.

6. Clique em CONTINUAR. A seção Testar perfil de conexão da página Criar perfil do Spanner está ativa.

7. Clique em EXECUTAR TESTE para verificar se o Datastream pode se comunicar com a origem.

   Se o teste falhar, analise o erro e faça as mudanças necessárias antes de testar novamente.

8. Clique em CRIAR.

Criar um perfil de conexão para uma instância do Workday

1. Acesse a página Perfis de conexão no console do Google Cloud .

   Acessar a página "Perfis de conexão"

2. Clique em CRIAR PERFIL.

3. Na página Criar um perfil de conexão, clique no tipo de perfil Workday.

4. Use a tabela a seguir para preencher os campos da seção Definir configurações de conexão:

   Campo	Descrição
   Nome do perfil de conexão	Insira o nome de exibição do perfil de conexão com a instância de origem do Workday.
   ID do perfil de conexão	O Datastream preenche esse campo automaticamente com base no nome inserido. Você pode manter o ID gerado automaticamente ou alterá-lo.
   Região	Selecione a região em que o perfil de conexão é armazenado. Um stream só pode usar perfis de conexão armazenados na mesma região.
   Host	Insira o nome do host da sua instância do Workday, por exemplo, wd5-impl.workday.com. O nome do host geralmente é derivado do URL de login da instância. Para mais informações, consulte Configurar uma instância do Workday para replicação de dados.
   Locatário	Insira o nome curto ou o alias do locatário do Workday, por exemplo, google. Esse valor identifica seu ambiente específico no host do Workday. Para mais informações, consulte Configurar uma instância do Workday para replicação de dados.
   ID do cliente	Insira o ID do cliente recuperado durante o registro do cliente da API no Workday. Para mais informações, consulte Configurar uma instância do Workday para replicação de dados.
   Chave secreta do cliente	Insira a chave secreta do cliente associada ao seu cliente de API. Insira o valor bruto ou selecione um secret no Secret Manager.
   Token de atualização	Insira o token de atualização gerado para o usuário do sistema de integração. Para maior segurança, recomendamos armazenar esse valor no Secret Manager. Para mais informações, consulte Configurar uma instância do Workday para replicação de dados.

5. Também é possível usar rótulos para organizar os recursos do Datastream.

   1. Para criar um rótulo, clique em ADICIONAR MARCADOR e insira o par de chave-valor.
   2. Para remover o rótulo, clique no ícone da lixeira à direita da linha que contém esse rótulo.

6. Clique em CONTINUAR.

7. Na seção Revisar método de conectividade, revise os endereços IP regionais do Datastream listados. Verifique se a organização do Workday está configurada para aceitar conexões recebidas desses endereços.

8. Clique em CONTINUAR. A seção Testar perfil de conexão está ativa.

9. Clique em EXECUTAR TESTE para verificar se o Datastream pode se comunicar com a instância de origem do Workday.

10. Clique em CRIAR.

Criar um perfil de conexão para o BigQuery

Observação :estas instruções também se aplicam ao destino de tabelas do Apache Iceberg.

1. Acesse a página Perfis de conexão no console do Google Cloud .

   Acessar a página "Perfis de conexão"

2. Clique em CRIAR PERFIL.

3. Na página Criar um perfil de conexão, clique no tipo de perfil BigQuery.

4. Use a tabela a seguir para preencher os campos da página Criar perfil do BigQuery:

   Campo	Descrição
   Nome do perfil de conexão	Insira o nome de exibição do perfil de conexão com os conjuntos de dados de destino no BigQuery. É usado na lista de perfis de conexão e também quando um perfil de conexão existente é selecionado na criação de um stream.
   ID do perfil de conexão	Mantenha o valor gerado automaticamente que é preenchido nesse campo.
   Região	Selecione a região em que o perfil de conexão é armazenado. Os perfis de conexão, assim como todos os recursos, são salvos em uma região, e um stream só pode usar perfis de conexão armazenados na mesma região do stream. A seleção de região não afeta a capacidade do Datastream de se conectar à origem ou ao destino, mas pode afetar a disponibilidade se a região tiver um período de inatividade. Embora a região selecionada para o perfil de conexão seja independente do tipo de local selecionado para o conjunto de dados de destino do BigQuery, recomendamos manter todos os recursos do stream na mesma região dos dados de origem para otimizar custos e desempenho.

5. Também é possível usar rótulos para organizar os recursos do Datastream.

   1. Para criar um rótulo, clique em ADICIONAR MARCADOR e insira o par de chave-valor.
   2. Para remover o rótulo, clique no ícone da lixeira à direita da linha que contém esse rótulo.

6. Clique em CRIAR.

Criar um perfil de conexão para o Cloud Storage

1. Acesse a página Perfis de conexão no console do Google Cloud .

   Acessar a página "Perfis de conexão"

2. Clique em CRIAR PERFIL.

3. Na página Criar um perfil de conexão, clique no tipo de perfil Cloud Storage.

4. Use a tabela a seguir para preencher os campos da página Criar perfil do Cloud Storage:

   Campo	Descrição
   Nome do perfil de conexão	Insira o nome de exibição do perfil de conexão com o bucket de destino no Cloud Storage. É usado na lista de perfis de conexão e também quando um perfil de conexão existente é selecionado na criação de um stream.
   ID do perfil de conexão	Mantenha o valor gerado automaticamente que é preenchido nesse campo.
   Região	Selecione a região em que o perfil de conexão é armazenado. Os perfis de conexão, assim como todos os recursos, são salvos em uma região, e um stream só pode usar perfis de conexão armazenados na mesma região do stream. A seleção de região não afeta a capacidade do Datastream de se conectar à origem ou ao destino, mas pode afetar a disponibilidade se a região tiver um período de inatividade.
   Nome do bucket	Clique em NAVEGAR para criar ou selecionar o bucket de destino no Cloud Storage para onde o Datastream transferirá os dados do banco de dados de origem. Se você selecionar um bucket, conclua as seguintes etapas: Clique no ícone Pesquisar (que aparece como uma lupa). No campo Pesquisar por nome, insira os primeiros caracteres do nome do bucket que você quer selecionar. O Datastream filtra a lista de buckets para refletir o que você insere no campo. Selecione o bucket que você quer usar como destino. Clique em SELECIONAR. Seu bucket aparece no campo Nome do bucket. Se preferir, clique no ícone Criar novo bucket, que aparece como uma pasta, para criar um bucket.

5. Opcionalmente, no campo Prefixo do caminho do perfil de conexão, é possível fornecer um prefixo para o caminho que será anexado ao nome do bucket quando o Datastream transferir dados para o destino.

   Observação: todo caminho inserido nesse campo precisa começar com uma barra (/).

6. Também é possível usar rótulos para organizar os recursos do Datastream.

   1. Para criar um rótulo, clique em ADICIONAR MARCADOR e insira o par de chave-valor.
   2. Para remover o rótulo, clique no ícone da lixeira à direita da linha que contém esse rótulo.

7. Clique em CRIAR.

Após criar perfis de conexão, você poderá ver informações detalhadas e detalhadas sobre eles.

A seguir

• Saiba como modificar perfis de conexão.
• Saiba como visualizar perfis de conexão.
• Saiba como excluir perfis de conexão.
• Saiba como o Datastream funciona com fontes do Dataverse.