Estabelecer Conexão com o OCI Object Storage

Aprenda a criar uma conexão com o OCI Object Storage para uso como destino ao OCI GoldenGate.

Antes de começar

Se você quiser usar controladores de recursos para autenticar e estabelecer conexão com um recurso do OCI, certifique-se de:

Se quiser usar Vault e Segredos, certifique-se de adicionar as políticas para permitir o acesso, como usar segredos, usar vaults e ler pacotes de segredos. Para obter mais informações, consulte Políticas mínimas recomendadas.

Criar a conexão

Para criar uma conexão do OCI Object Storage:
  1. Na página Visão Geral do OCI GoldenGate, clique em Conexões.
    Você também pode clicar em Criar Conexão na seção Conceitos Básicos e ir direto para a etapa 3.
  2. Na página Conexões, clique em Criar Conexão.
  3. Na página Criar Conexão, preencha os campos da seguinte forma:
    1. Para Nome, digite um nome para a conexão.
    2. (Opcional) Para Descrição, informe uma descrição que ajude a distinguir essa conexão de outras.
    3. Para Compartimento, selecione o compartimento no qual a conexão será criada.
    4. Para Tipo, selecione OCI Object Storage.
    5. Para Região, selecione a região do OCI Object Storage.
    6. Para Usuário, selecione uma das seguintes opções:
      • Use a tenancy e o usuário atuais e especifique as seguintes informações:
        1. Selecione o Segredo da chave privada. Se estiver localizado em outro compartimento, use a lista drop-down para alterar compartimentos.
        2. Selecione o Segredo da frase-senha da chave privada. Se estiver localizado em outro compartimento, use a lista drop-down para alterar compartimentos.
        3. Para Senha da chave privada, digite a impressão digital da chave pública correspondente.
      • Use o controlador de recursos para autenticar e acessar outros recursos do OCI.
      • Especifique outra tenancy e outro usuário e, em seguida, informe as seguintes informações:
        1. Informe o OCID da Tenancy.
        2. Informe o OCID do Usuário.
        3. Selecione o Segredo da chave privada. Se estiver localizado em outro compartimento, use a lista drop-down para alterar compartimentos.
        4. Selecione o Segredo da frase-senha da chave privada. Se estiver localizado em outro compartimento, use a lista drop-down para alterar compartimentos.
        5. Para Senha da chave privada, digite a impressão digital da chave pública correspondente.

      Observação:

      • Segredos são credenciais como senhas, certificados, chaves SSH ou tokens de autenticação usados com os serviços do OCI. Para criar um segredo, consulte Criando um segredo. Verifique se:
        • Selecione Geração de segredo manual.
        • Cole as credenciais no conteúdo do segredo.
      • Se preferir não usar segredos de senha, certifique-se de desmarcar Usar segredos no vault na seção Segurança em Opções Avançadas, localizada na parte inferior deste formulário.
    7. Expanda Mostrar opções avançadas. Você pode configurar as seguintes opções;
      • Segurança
        • Desmarque Usar segredos do vault para que você prefira não usar segredos de senha para esta conexão. Caso não esteja selecionado:
          • Selecione Usar chave de criptografia gerenciada pela Oracle para deixar para a Oracle todo o gerenciamento de chaves de criptografia.
          • Selecione Usar chave de criptografia gerenciada pelo cliente para selecionar uma chave de criptografia específica armazenada no OCI Vault para criptografar suas credenciais de conexão.
      • Conectividade de rede
        • Ponto final compartilhado, para compartilhar um ponto final com a implantação atribuída. Você deve permitir conectividade com base no IP de entrada da implantação.
        • Ponto final dedicado, para tráfego de rede por meio de um ponto final dedicado na sub-rede designada na sua VCN. Você deve permitir conectividade dos IPs de entrada dessa conexão.

          Observação:

          • Se uma conexão dedicada permanecer não designada por sete dias, o serviço a converterá em uma conexão compartilhada.
          • Saiba mais sobre a conectividade do Oracle GoldenGate.
      • Tags: Adicione tags para organizar seus recursos.
  4. Clique em Criar.
Depois que a conexão é criada, ela aparece na lista Conexões. Certifique-se de designar a conexão a uma implantação para usá-la como origem ou destino em uma replicação.

Problemas Conhecidos

Erro de replicação do OCI Object Storage ao usar o Controlador de Recursos

Se sua conexão do OCI Object Storage usar a autenticação do Controlador de Recursos, o processo Replicat falhará com o seguinte erro:
ERROR 2025-06-12 14:48:16.000489 [main] - An exception has occurred: java.lang.NullPointerException: Cannot invoke "String.startsWith(String)" because "path" is null java.lang.NullPointerException: Cannot invoke "String.startsWith(String)" because "path" is null

Solução alternativa: para contornar esse problema, edite a conexão e selecione outro método de autenticação.

Incompatibilidade de OCID do Usuário na conexão do OCI Object Storage (Somente usuários federados)

Se um usuário federado selecionar Utilizar usuário atual ao criar uma conexão do OCI Object Storage, seu OCID não corresponderá ao OCID selecionado pelo sistema.

Solução alternativa: Ao criar uma conexão do OCI Object Storage, certifique-se de escolher Especificar outro usuário e, em seguida, informe o OCID do usuário federado.

Para localizar o OCID do usuário, clique em Perfil no cabeçalho global da console do Oracle Cloud e selecione o nome do usuário. Na página Detalhes do Usuário, em Informações do Usuário, clique em Mostrar para OCID.