Estabelecer Conexão com o Oracle Object Storage

Aprenda a criar uma conexão para o Oracle Object Storage para usar como destino com 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:

Crie um grupo dinâmico para a sua implantação. Você pode optar por autorizar uma única implantação ou toda a implantação em um compartimento ou tenancy. Consulte Gravando regras de correspondência para definir grupos dinâmicos. Por exemplo:
```
ALL {resource.type = 'goldengatedeployment', resource.compartment.id = 'compartment_ocid'}
```

Adicione as políticas necessárias ao grupo dinâmico. Por exemplo:

allow dynamic-group <dynamic-group-name> to manage object-family in tenancy

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 Oracle Object Storage:

Na página Visão Geral do OCI GoldenGate, selecione Conexões.

Você também pode selecionar Criar Conexão na seção Conceitos básicos e pular para a etapa 3.
Na página Conexões, selecione Criar Conexão.
Na página Criar Conexão, preencha os campos da seguinte forma:
1. Para Nome, informe 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. (Somente para o GoldenGate no Multinuvem) Selecione sua Assinatura e preencha os campos a seguir.
  1. Na lista drop-down Compartimento, selecione o compartimento no qual reside a Âncora de Recursos.
  2. Selecione a Região de parceiros multicloud.
  3. Selecione sua Zona de disponibilidade do parceiro. As opções disponíveis são preenchidas com base na região de parceiro Multinuvem selecionada.
4. Para Compartimento, selecione o compartimento no qual a conexão será criada.
5. Para Tipo, selecione Oracle Object Storage.
6. Para Região, selecione a região do Oracle Object Storage.
7. 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. (Opcional) 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 Impressão digital de chave pública, informe a chave de API criada para o usuário.
  - 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 Impressão digital de chave pública, informe a chave de API criada para o usuário.
  Observação:
  - Segredos são credenciais como senhas, certificados, chaves SSH ou tokens de autenticação usados nos 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.
  - Quando precisar atualizar o conteúdo do Segredo, certifique-se de:
    - Crie uma nova versão de Segredo usando o modelo de Texto Simples e forneça o conteúdo atualizado. Para obter mais informações, consulte Atualizando o Conteúdo de um Segredo.
    - Atualizar a conexão para limpar o conteúdo do Segredo armazenado no cache.
8. 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 todo o gerenciamento de chaves de criptografia para a Oracle.
      - 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 a conectividade do 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 a 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.
  - Atributos de segurança: Adicione atributos de segurança para controlar o acesso a essa conexão usando o ZPR (Zero Trust Packet Routing).
  - Tags: Adicione tags para organizar seus recursos.
Selecione 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 destino em uma replicação.

Próximas etapas

Problemas Conhecidos

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

Se a conexão do Oracle 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 do OCID do Usuário na conexão do Oracle Object Storage (Somente usuários federados)

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

Solução alternativa: ao criar uma conexão do Oracle Object Storage, escolha Especificar outro usuário e digite o OCID do usuário federado.

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