As regiões de nuvem do governo são necessárias para dar suporte aos padrões de conformidade com FIPS para proteção de dados. A Transformação de Dados em domínios Governamentais é compatível com o FIPS 140-2 Nível 1. Certifique-se de que as origens de conexões estejam em conformidade com o FIPS para garantir a comunicação segura entre os servidores.

Observação

APLICA-se a: Data Transforms disponível como uma listagem separada no Marketplace chamada Data Integrator: Web Edition.

• Para os conectores que exigem instalação de driver, copie os arquivos jar para o diretório /u01/oracle/transforms_home/userlibs antes de adicionar a conexão.
• Além dos tipos de conexão listados aqui, você pode criar conectores personalizados, que podem ser usados para conectar o Data Transforms a quaisquer origens de dados JDBC suportadas. Consulte Criar Conectores Personalizados.

Para criar um novo conector:

1. No painel esquerdo, clique em Administração.

   Uma mensagem de advertência é exibida.

2. Clique em Continuar.
3. No painel esquerdo, clique em Conexões Personalizadas.

   A tela Conexões Personalizadas é exibida.

4. Clique em Criar Tipo de Conexão.

   Será exibida a página Criar Tipo de Conexão.

5. Na lista drop-down Categoria, selecione o tipo de conexão que você deseja criar, seja banco de dados, aplicativo ou serviço.
6. Digite um nome para a conexão.
7. Informe o nome do Driver JDBC da conexão de origem. Por exemplo, oracle.jdbc.OracleDriver.
   Observação
   
   Para conectores que exigem instalação do driver, você precisa copiar os arquivos jar para o diretório /u01/oracle/transforms_home/userlibs antes de adicionar a conexão.
8. Clique em OK.

A conexão personalizada recém-criada aparece na lista e está disponível na página Criar Conexão.

Clique no ícone Ações () ao lado da conexão selecionada para executar as seguintes operações:

• Selecione Editar para editar os detalhes fornecidos da conexão.
• Clique em Exportar para exportar a conexão. Consulte Exportar Objetos.
• Selecione Excluir para excluir a conexão criada.
  Observação
  
  Você não pode excluir conectores personalizados que tenham conexões existentes.

Para definir uma conexão do Data Transforms:

As novas conexões são exibidas na página Connections.

Clique no ícone Ações () ao lado da conexão selecionada para executar as seguintes operações:

• Selecione Editar para editar os detalhes fornecidos da conexão.
• Selecione Test Connection para testar a conexão criada.
• Clique em Exportar para exportar a conexão. Consulte Exportar Objetos.
• Selecione Excluir Esquema para excluir esquemas.
• Selecione Excluir Conexão para excluir a conexão criada.

Você também pode procurar a conexão necessária para saber seus detalhes com base nos seguintes filtros:

• Nome da Conexão.
• Tecnologia associada à Conexão criada.

O Data Transforms suporta o Oracle Object Storage (compatibilidade com S3) e os serviços de armazenamento do AWS S3 para armazenar os arquivos parquet das tabelas do Apache Iceberg.

O Data Transforms Apache Iceberg Connector requer que já exista um Catálogo REST. Este Catálogo REST é configurado com base no Apache Gravitino (link externo) com a especificação Iceberg Open API.

• Criando uma Conexão do Iceberg Apache
• Criando e Executando um Carregamento de Dados do Apache Iceberg

Criando uma Conexão do Iceberg Apache

Você pode configurar uma conexão do Apache Iceberg com o Catálogo REST do Iceberg fornecendo o URL REST e detalhes de autenticação, como o nome de usuário e a senha. Você também pode usar a autenticação mais segura do OAuth 2.0 para criar a conexão.

Para criar uma conexão do Apache Iceberg:

1. No painel esquerdo da Home page, clique na guia Connections.

   A página Connections é exibida.

2. Clique em Criar Conexão.

   A página Criar Conexão é apresentada.

3. Execute um dos seguintes procedimentos:
   • No campo Selecionar Tipo, informe o nome ou parte do nome do tipo de conexão.
   • Selecione a guia Bancos de Dados.
4. Selecione Apache Iceberg como o tipo de conexão.
5. Clique em Próximo.
6. O campo Nome da Conexão é pré-preenchido com um nome padrão. Você pode editar esse valor.
7. Na caixa de texto Nome do Catálogo, informe um nome.
8. Na caixa de texto URL de Rest, informe o URL do servidor REST. Informe o valor no formato <host>:<port>/<ServiceName>/iceberg.
9. Na seção drop-down Autenticação, execute um dos seguintes procedimentos:
   • Selecione Nenhum.
   • Selecione Simples e informe o Usuário Rest e a Senha Rest.
   • Selecione OAuth e informe os seguintes detalhes:
     • Local do Depósito: O local onde você deseja armazenar os dados. Por exemplo, s3://my-bucket/my/table/location
     • URI de Token: O URL para obter o Token OAuth no formato http://<host>:<port>
     • Caminho do Token: O caminho para o token OAuth. Por exemplo, /oauth2/token.
     • ID do Cliente: O ID do Cliente OAuth.
     • Segredo do Cliente: O segredo do Cliente OAuth.
     • Escopo de Autenticação: As permissões concedidas a um cliente ao acessar o servidor Gravitino. Por exemplo, um valor de Escopo de Autenticação test pode indicar que o cliente está autorizado a acessar recursos relacionados ao escopo de teste" no Gravitino. [Opcional]
     • Tipo de Concessão: O método que o servidor de autorização deve usar para emitir o token de acesso. Por exemplo, client_credentials e authorization_code. [Opcional]
10. Clique em Testar Conexão, para testar a conexão estabelecida.
11. Depois de fornecer todos os detalhes de conexão exigidos, clique em Criar.

    A conexão do Apache Iceberg é configurada com o Catálogo REST, que armazena os dados do Iceberg no Oracle Object Storage.

As novas conexões são exibidas na página Connections.

Clique no ícone Ações () ao lado da conexão selecionada para executar as seguintes operações:

• Selecione Editar para editar os detalhes fornecidos da conexão.
• Selecione Test Connection para testar a conexão criada.
• Clique em Exportar para exportar a conexão. Consulte Exportar Objetos.
• Selecione Excluir Esquema para excluir esquemas.
• Selecione Excluir Conexão para excluir a conexão criada.

Você também pode procurar a Conexão necessária para saber seus detalhes com base nos seguintes filtros:

• Nome da Conexão.
• Tecnologia associada à Conexão criada.

Criando e Executando um Carregamento de Dados do Apache Iceberg

Você pode criar um carregamento de dados para qualquer origem de dados de origem baseada em SQL, como o Oracle, para carregar dados nas tabelas de destino do Apache Iceberg. Para usar o Apache Iceberg como origem de dados de destino, você precisa fornecer o nome da conexão e o namespace. Um namespace no Apache Iceberg é semelhante ao esquema em bancos de dados relacionais.

Depois que você criar o carregamento de dados, todas as tabelas no esquema de origem serão listadas na página Detalhes do Carregamento de Dados, juntamente com opções para carregar, anexar e mesclar incrementalmente os dados de cada uma das tabelas de origem selecionadas. Quando a execução do carregamento de dados for concluída, você poderá ler os dados das tabelas do Iceberg. Você pode adicionar o carregamento de dados como uma etapa em um workflow e criar uma programação para executar os workflows em um intervalo de tempo predefinido. Consulte Criar um Novo Workflow.

Para criar e executar um Carregamento de Dados do Apache Iceberg:

1. Execute um dos seguintes procedimentos:
   • Na Página Inicial, clique em Carregar Dados. O assistente Criar Carga de Dados é exibido.

     Na guia Criar Carga de Dados, informe um nome se quiser substituir o valor padrão, adicionar uma descrição e selecionar um projeto na lista suspensa.

   • Na Home page, clique em Projetos e, em seguida, no mosaico do projeto necessário. No painel esquerdo, clique em Cargas de Dados e clique em Criar Carga de Dados. O assistente Criar Carga de Dados é exibido.
2. Insira um nome se quiser substituir o valor padrão e adicionar uma descrição.
3. Para Processamento de Carga, execute um dos seguintes procedimentos:
   • Selecione o botão de opção Interno e, na lista suspensa Tipo de Implantação, selecione Transformações de Dados (Batch).
   • Selecione o botão de opção Delegar e, na lista suspensa Tipo de Implantação, selecione OCI GoldenGate. Na Conexão de Implantação GoldenGate, selecione uma conexão.
4. Clique em Próximo.
5. Na guia Conexão de Origem,
   1. Na lista drop-down Tipo de Conexão, selecione uma origem de dados baseada em SQL.
   2. na lista drop-down conexão, selecione a conexão necessária cujas entidades de dados você deseja adicionar.
   3. Clique em Próximo.
6. Na guia Conexão de Destino,
   1. Na lista drop-down Tipo de Conexão, selecione Apache Iceberg como o tipo de conexão.
   2. Na lista drop-down Conexão, selecione a conexão na qual deseja usar para carregar os dados.
   3. Especifique o Namespace. Você pode selecionar entre namespaces existentes ou criar um novo namespace.
   4. Clique em Salvar.

   A página Detalhes da Carga de Dados é exibida listando todas as tabelas de origem.

7. Selecione as tabelas necessárias para carregar e a operação de carregamento de dados correspondente. As opções de carregamento de dados que você pode usar são Mesclagem Incremental, Anexação Incremental, Anexar e Não Carregar.
8. Clique em para salvar as alterações. Uma marca de seleção verde () na linha indica que as alterações foram salvas.
9. Clique em para executar a carga de dados.

   Um prompt de confirmação é exibido quando a carga de dados é iniciada com sucesso.

Para verificar o status do carregamento de dados, consulte o painel Status do Carregamento de Dados à direita abaixo dos detalhes do Esquema de Destino. Para obter detalhes sobre o painel, consulte Monitorar Status de Cargas de dados, Fluxos de dados e Fluxos de trabalho. Este painel mostra links para os jobs executados para executar este carregamento de dados. Clique no link para monitorar o andamento na página Detalhes da Tarefa. Para obter mais informações sobre jobs, consulte Criar e Gerenciar Jobs.

Todas as tabelas carregadas e seus detalhes são listados na página Entidades de Dados. Para exibir as estatísticas das entidades de dados, clique no ícone Ações () ao lado da entidade de dados, clique em Visualizar e selecione a guia Estatísticas. Consulte Exibir Estatísticas de Entidades de Dados para obter informações.

Para usar o Databricks como origem, você precisa especificar o URL do servidor de compartilhamento Delta junto com o token do portador que permite acessar o servidor de compartilhamento Delta Lake. Para usar o Oracle Data Share como origem, você precisa especificar o URL do ponto final do token juntamente com um ID de cliente e a chave secreta.

• Criando a Conexão de Compartilhamento Delta
• Criando e Executando uma Carga de Dados de Compartilhamento Delta

Criando a Conexão de Compartilhamento Delta

Para definir uma conexão do Delta Share:

1. No painel esquerdo da Home page, clique na guia Connections.

   A página Connections é exibida.

2. Clique em Criar Conexão.

   A página Criar Conexão é apresentada.

3. Execute um dos seguintes procedimentos:
   • No campo Selecionar Tipo, informe o nome ou parte do nome do tipo de conexão.
   • Selecione a guia Bancos de Dados.
4. Selecione Compartilhamento Delta como o tipo de conexão.
5. Clique em Próximo.
6. O campo Nome da Conexão é pré-preenchido com um nome padrão. Você pode editar esse valor.
7. Na caixa de texto Compartilhar URL do Ponto Final, informe o URL do servidor de Compartilhamento Delta. Informe o valor no formato <host>:<port>/<shareEndpoint>/.
8. Na seção Conexão, faça o seguinte:
   • Selecione Oracle Data Share e forneça o URL do Ponto Final do Token, o ID do Cliente e o Segredo do Cliente para acessar o compartilhamento.

     Você pode obter essas informações do documento JSON do Perfil de Compartilhamento Delta que precisará fazer download fornecido a você pelo Provedor de Compartilhamento. (É aqui que eles obtêm o URL do Ponto Final de Compartilhamento)

     Você pode obter essas informações do documento JSON do Perfil de Compartilhamento Delta que você pode fazer download do link de ativação fornecido pelo provedor de Compartilhamento de Dados para acessar seu compartilhamento.

   • Selecione Databricks e, na caixa de texto Token do Portador, informe o token para conexão com o servidor de Compartilhamento Delta.
9. Se você precisar usar um proxy para acessar o Delta Share Server ou o Delta Share Storage, configure as seguintes definições:
   • Na caixa de texto Host Proxy, informe o nome do host do servidor proxy a ser usado para a conexão.
   • Na caixa de texto Porta Proxy, informe o número da porta do servidor proxy.
   • Marque as seguintes caixas de seleção, dependendo de onde o proxy é necessário:
     • Usar proxy para acessar o Delta Share Server
     • Usar proxy para acessar o Delta Share Storage
10. Clique em Testar Conexão, para testar a conexão estabelecida.
11. Depois de fornecer todos os detalhes de conexão exigidos, clique em Criar.

    A nova conexão foi criada.

As novas conexões são exibidas na página Connections.

Clique no ícone Ações () ao lado da conexão selecionada para executar as seguintes operações:

• Selecione Editar para editar os detalhes fornecidos da conexão.
• Selecione Test Connection para testar a conexão criada.
• Clique em Exportar para exportar a conexão. Consulte Exportar Objetos.
• Selecione Excluir Esquema para excluir esquemas.
• Selecione Excluir Conexão para excluir a conexão criada.

Você também pode procurar a Conexão necessária para saber seus detalhes com base nos seguintes filtros:

• Nome da Conexão.
• Tecnologia associada à Conexão criada.

Criando e Executando uma Carga de Dados de Compartilhamento Delta

Para carregar dados do Delta Share no Oracle Autonomous Database, o usuário de conexão da Oracle deve ser um usuário Admin. Os privilégios de administrador são necessários para que o usuário Oracle possa criar e inserir dados em tabelas em outro esquema.

Quando você executa o carregamento de dados, o Data Transforms carrega os dados em uma tabela correspondente no esquema de destino. O carregamento de dados é executado de forma incremental. Na primeira vez que você executa um carregamento de dados, o Data Transforms copia todos os dados em novas tabelas. Para cada execução de carregamento de dados subsequente, ele só faz upload das alterações. Todas as adições ou exclusões nos registros serão refletidas nas tabelas de destino. Observe que se houver qualquer alteração de metadados na tabela, por exemplo, uma coluna for adicionada, o Data Transforms criará uma nova tabela para carregar os dados no servidor de destino. Você pode criar um workflow, adicionar o carregamento de dados como uma etapa, criar um agendamento para executar os workflows em um intervalo de tempo predefinido. Consulte Criar um Novo Workflow.

Para criar e executar uma carga de dados do Delta Share:

1. Execute um dos seguintes procedimentos:
   • Na Home page, clique em Carregar Dados. O assistente de Criação de Carga de Dados é exibido.

     Na guia Criar Carregamento de Dados, informe um nome se quiser substituir o valor padrão, adicionar uma descrição e selecionar um projeto no menu suspenso.

   • Na Home page, clique em Projetos e, em seguida, no mosaico do projeto necessário. No painel esquerdo, clique em Carregamentos de Dados e, em seguida, clique em Criar Carregamento de Dados. O assistente de Criação de Carga de Dados é exibido.

     Na guia Criar Carga de Dados, informe um nome se quiser substituir o valor padrão e adicionar uma descrição.

2. Clique em Próximo.
3. Na guia Conexão de Origem,
   1. No menu suspenso Tipo de Conexão, selecione Compartilhamento Delta.
   2. na lista drop-down Conexão, selecione a conexão necessária na qual você deseja adicionar as entidades de dados.
   3. Selecione o compartilhamento que você deseja carregar tabelas na lista drop-down Compartilhar. A lista drop-down lista todos os compartilhamentos da conexão selecionada.
   4. Clique em Próximo.
4. Na guia Conexão de Destino,
   1. Na lista suspensa Tipo de Conexão, selecione Oracle como o tipo de conexão.
      Observação
      
      Esta lista drop-down lista apenas conexões do tipo JDBC.
   2. Na lista drop-down Conexão, selecione a conexão necessária para carregar as entidades de dados.
   3. Informe um nome exclusivo na caixa de texto Esquema.
   4. Clique em Salvar.
   A página Detalhes da Carga de Dados é exibida listando todas as tabelas no compartilhamento selecionado com seus nomes de esquema.

   Observação
   
   Para dados de Compartilhamento Delta, a página Detalhes da Carga de Dados só inclui a opção . Não é possível aplicar diferentes ações - mesclagem incremental, acréscimo incremental, recriação, truncamento, acréscimo - nas entidades de dados antes de carregá-las para o esquema de destino. Isso serve para garantir que os dados sejam consistentes entre o servidor de Compartilhamento Delta e o esquema de destino.
5. Clique em para executar o carregamento de dados.

   Um prompt de confirmação é exibido quando o carregamento de dados é iniciado com sucesso.

Para verificar o status da carga de dados, consulte o painel Status à direita, abaixo dos detalhes do Esquema de Destino. Para obter detalhes sobre o painel Status, consulte Monitorar o Status de Cargas de Dados, Fluxos de Dados e Workflows. Esse painel mostra links para os jobs que são executados para executar essa carga de dados. Clique no link para monitorar o andamento na página Detalhes do Job. Para obter mais informações sobre jobs, consulte Criar e Gerenciar Jobs.

Todas as entidades de dados carregadas com seus detalhes são listadas na página Entidades de Dados. Para exibir as estatísticas das entidades de dados, clique no ícone Ações () ao lado da entidade de dados, clique em Visualizar e selecione a guia Estatísticas. Consulte Exibir Estatísticas de Entidades de Dados para obter informações.

Para criar uma conexão do Oracle BICC, primeiro configure o armazenamento externo usando a guia Conexão do OCI Object Storage na Console do BICC. Você precisa especificar esses detalhes de conexão ao definir a conexão no Oracle Data Transforms.

Você pode usar a conexão BICC para escolher as ofertas cujos armazenamentos de dados deseja extrair. O Data Transforms usa um Oracle Object Storage Data Server usado pelo Oracle BICC para preparar os arquivos extraídos, que você pode usar como origem para mapeamento. Observe que você não pode usar uma conexão do Oracle BICC como destino para mapeamento.

Para definir uma conexão do Oracle BICC,

As novas conexões são exibidas na página Connections.

Clique no ícone Ações () ao lado da conexão selecionada para executar as seguintes operações:

• Selecione Editar para editar os detalhes fornecidos da conexão.
• Selecione Test Connection para testar a conexão criada.
• Clique em Exportar para exportar a conexão. Consulte Exportar Objetos.
• Selecione Excluir Esquema para excluir esquemas.
• Selecione Excluir Conexão para excluir a conexão criada.

Você também pode procurar a Conexão necessária para saber seus detalhes com base nos seguintes filtros:

• Nome da Conexão.
• Tecnologia associada à Conexão criada.

Para definir a Conexão do Oracle Cloud Infrastructure Generative AI:

1. No painel esquerdo da Home page, clique na guia Conexões.

   A página Connections é exibida.

2. Clique em Criar Conexão.

   A página Criar Conexão é apresentada.

3. Para Selecionar Tipo,
   • No campo Nome, informe o nome da conexão recém-criada.
   • Selecione Serviços como o tipo de conexão.
4. Selecione OCI Generative AI e Next.
5. Para Detalhes da Conexão, forneça os seguintes detalhes:
   • URL do OCI - O URL do ponto final do serviço OCI Generative AI.
   • OCID do Usuário - O OCID do usuário na Console do Oracle Cloud Infrastructure.
   • OCID da Tenancy - O OCID da tenancy na Console do Oracle Cloud Infrastructure.
   • OCID do Compartimento - O OCID do compartimento da Console do Oracle Cloud Infrastructure.
   • Chave Privada - A chave privada no formato PEM. Especifique o caminho para seu arquivo de chave privada submetido a download.
   • Impressão Digital - A impressão digital da chave recém-adicionada.
6. Depois de provar todos os detalhes de conexão necessários, clique em Criar.

   A nova conexão foi criada.

7. Clique em Testar Conexão, para testar a conexão estabelecida.

   Um pop-up é exibido listando as conexões do Oracle Database 23ai que você configurou. Selecione a opção que deseja usar para testar esta conexão.

   Observação
   
   Se a conexão de teste falhar, consulte Diagnosticando e Solucionando Problemas de Conexão do OCI Generative AI para obter instruções sobre como corrigir o problema.

A conexão recém-criada é exibida na página Conexões.

Diagnosticando e solucionando problemas de conexão do OCI Generative AI

Se a opção Testar Conexão falhar para uma conexão do OCI Generative AI, faça o seguinte para solucionar o problema:

1. Certifique-se de ter inserido todas as informações de conexão corretamente. Por exemplo,
   • Amostra de URL do OCI: https://inference.generativeai.us-chicago-1.oci.oraclecloud.com/20231130/actions/embedText
   • Amostra de chave privada: MIIEvg......beE/
2. Ao clicar em Testar Conexão, você será solicitado a escolher uma Conexão Oracle. Certifique-se de que seja uma conexão do Oracle 23ai.
3. Faça log-in no banco de dados Oracle 23ai como administrador e execute a seguinte consulta para garantir que os status sejam válidos:

   SELECT object_name, object_type, status
   FROM dba_objects
   WHERE object_name = 'DBMS_VECTOR_CHAIN' AND owner = 'CTXSYS';

4. Verifique se o seguinte bloco plsql funciona no seu banco de dados. O Data Transforms usa o bloco plsql para executar o Testar Conexão.

   exec dbms_vector_chain.drop_credential('OCI_CRED');
   declare
     jo json_object_t;
   begin
     -- create an OCI credential
     jo := json_object_t();
     jo.put('user_ocid', '<your user ocid>');
     jo.put('tenancy_ocid', '<your tenancy ocid');
     jo.put('compartment_ocid', '<your compartment ocid');
     jo.put('private_key', '<your private key');
     jo.put('fingerprint', '<your fingerprint>');
     dbms_output.put_line(jo.to_string);
     dbms_vector_chain.create_credential(
       credential_name => 'OCI_CRED',
       params => json(jo.to_string));
   end; 

   select dbms_vector_chain.utl_to_embedding('hello', JSON('{"provider": "ocigenai","credential_name" : "OCI_CRED", "url": "https://inference.generativeai.us-chicago-1.oci.oraclecloud.com/20231130/actions/embedText","model": "cohere.embed-english-light-v2.0"}')) from dual;

   Se você receber um erro HTTP request failed ao executar a consulta de bloco plsql, tente conceder acesso de rede ao seu usuário:

   BEGIN
       DBMS_NETWORK_ACL_ADMIN.APPEND_HOST_ACE(
           host => '*',
           ace => xs$ace_type(privilege_list => xs$name_list('connect'),
                              principal_name => '<your username>',
                              principal_type => xs_acl.ptype_db));
   END;

• Não é possível usar uma conexão do Oracle ERP Cloud como destino para mapeamento.
• O carregamento de dados não é suportado para conexões do Oracle ERP Cloud.

• Criando uma Conexão do Oracle ERP Cloud Server
• Importando Definições de Entidade de Dados de um Servidor Oracle ERP Cloud

Criando uma Conexão do Oracle ERP Cloud Server

Para criar essa conexão, você precisa especificar o URL WSDL do serviço de Relatório e o nome de usuário e a senha para estabelecer conexão com a instância do ERP Cloud.

Para definir uma Conexão do Oracle ERP Cloud Server:

1. No painel esquerdo da Home page, clique na guia Conexões.

   A página Connections é exibida.

2. Clique em Criar Conexão.

   A página Criar Conexão é apresentada.

3. Execute um dos seguintes procedimentos:
   • No campo Selecionar Tipo, informe o nome ou parte do nome do tipo de conexão.
   • Selecione a guia Aplicativos.
4. Selecione Oracle ERP Cloud como o tipo de conexão.
5. Clique em Próximo.
6. O campo Nome da Conexão é pré-preenchido com um nome padrão. Você pode editar esse valor.
7. Na caixa de texto URL WSDL, informe o URL do web service do BI Publisher usado para a instância do Oracle ERP Cloud. O formato do URL é BI Publisher Hostname/xmlpserver/services/PublicReportWSSService?wsdl.

   Por exemplo: https://fa-eudu-saasfademo1.ds-fa.oraclepdemos.com/xmlpserver/services/PublicReportWSSService?wsdl.

8. Na caixa de texto Host Proxy, informe o nome do host do servidor proxy a ser usado para a conexão.
9. Na caixa de texto Porta Proxy, informe o número da porta do servidor proxy.
10. Na caixa de texto Usuário, informe o nome do usuário para estabelecer conexão com a instância do Oracle ERP Cloud.
11. Na caixa Senha, informe a senha para estabelecer conexão com a instância do Oracle ERP Cloud.
12. Após fornecer todos os detalhes de conexão necessários, clique em Testar Conexão para testar a conexão.
13. Clique em Criar.

    A conexão recém-criada é exibida na página Conexões.

    Clique no ícone Ações () ao lado da conexão selecionada para executar as seguintes operações:

    • Selecione Editar para editar os detalhes fornecidos da conexão.
    • Selecione Test Connection para testar a conexão criada.
    • Clique em Exportar para exportar a conexão. Consulte Exportar Objetos.
    • Selecione Excluir Esquema para excluir esquemas.
    • Selecione Excluir Conexão para excluir a conexão criada.

    Você também pode procurar a conexão necessária para saber seus detalhes com base nos seguintes filtros:

    • Nome da conexão.
    • Tecnologia associada à conexão criada.

Importando Definições de Entidade de Dados de um Servidor Oracle ERP Cloud

Para conexões do Oracle ERP Cloud, a página Importar Entidades de Dados requer entrada em pares de chave/valor. Para importar dados, você precisa especificar a chave BIPReportLocation, que se refere ao local do relatório do BI Publisher no servidor BI. Você pode encontrar essas informações no servidor BI quando o relatório correspondente estiver aberto.

Para definir uma conexão do Oracle Financials Cloud,

As novas conexões são exibidas na página Connections.

Clique no ícone Ações () ao lado da conexão selecionada para executar as seguintes operações:

• Selecione Editar para editar os detalhes fornecidos da conexão.
• Selecione Test Connection para testar a conexão criada.
• Clique em Exportar para exportar a conexão. Consulte Exportar Objetos.
• Selecione Excluir Esquema para excluir esquemas.
• Selecione Excluir Conexão para excluir a conexão criada.

Você também pode procurar a Conexão necessária para saber seus detalhes com base nos seguintes filtros:

• Nome da Conexão.
• Tecnologia associada à Conexão criada.

• Configurando Permissões de Acesso Necessárias para Criar Data Warehouse
• Criação da conexão do Oracle NetSuite
• Usando o Assistente de Criação de Data Warehouse
• Executando os Fluxos de Trabalho Predefinidos para Carregar Dados no Esquema de Destino

Configurando Permissões de Acesso Necessárias para Criar Data Warehouse

Antes de criar uma conexão NetSuite ou usar o Assistente de criação de data warehouse em Data Transforms, você precisa fazer login no NetSuite como administrador, habilitar o SuiteAnalytics Connect, criar um papel personalizado e definir as permissões de acesso necessárias para criar o Data Warehouse do NetSuite.

Para configurar as permissões de acesso:

1. Faça log-in no NetSuite como administrador usando o seguinte URL:

   https://system.netsuite.com/pages/customerlogin.jsp

2. Verifique se o recurso SUITEANALYTICS CONNECT está habilitado.

   Vá para Configuração > Empresa > Habilitar recursos. Clique na aba Analytics e verifique se a caixa SuiteAnalytics Connect está marcada.

3. Adicione uma função personalizada.

   Vá para Configuração > Usuários/Funções > Gerenciamento de Usuário > Gerenciar Funções. Clique em Nova Função, adicione os detalhes necessários e clique em Salvar para criar uma função personalizada.

4. Atribua as permissões necessárias ao papel personalizado.

   Vá para Configuração > Usuários/Funções > Gerenciamento de Usuário > Gerenciar Funções. Clique em Personalizar ao lado do nome do papel personalizado ao qual você gostaria de adicionar a permissão do SuiteAnalytics Connect.

   Clique na guia Transações na guia Permissões e designe as seguintes permissões:

   • Detalhes da conta
   • Listas contábeis
   • Gerenciamento Contábil
   • Contas
   • Contas a Pagar
   • Gráfico de contas a pagar
   • Registro de contas a pagar
   • Contas a Receber
   • Gráficos de Contas a Receber
   • Registro de Contas a Receber
   • Ajustar estoque
   • Ajustar planilha de estoque
   • Relatórios de amortização
   • Cronogramas de amortização
   • Trilha de Auditoria
   • Balanço patrimonial
   • Registros de conta bancária
   • Faturar pedidos de compra
   • Programações de Faturamento
   • Faturas
   • Planilha do Armazenamento em Compartimento
   • Transferência de compartimento
   • Pedido de compra com entregas fracionadas
   • Criar montagens
   • Grupos de CRM
   • Calendário
   • Venda à Vista
   • Reembolso de venda à vista
   • Cobrança
   • Cobrança - Regras de execução
   • Regra de cobrança
   • Marcar
   • Aulas
   • Configuração do recurso de comissão
   • Relatórios de comissão
   • Confirmar pedidos
   • Confirmar folha de pagamento
   • Concorrentes
   • Utilização do Componente
   • Contatos
   • Contar estoque
   • Criar tabelas de alocação
   • Cartão de Crédito
   • Reembolso do Cartão de Crédito
   • Registros de cartão de crédito
   • Aviso de Crédito
   • Devoluções de crédito
   • Moeda
   • Reavaliação de moeda
   • Tipo de evento de reconhecimento personalizado
   • Depósito do Cliente
   • Pagamento do Cliente
   • Reembolso do cliente
   • Clientes
   • Relatórios de despesas diferidas
   • Registros Excluídos
   • Departamentos
   • Depósito
   • Aplicação de Depósito
   • Arquivos e Documentos
   • Editar Previsão
   • Editar Previsão do Gerente
   • Modelo de e-mail
   • Transação de comissão de funcionário
   • Aprovação de transação de comissão de funcionário
   • Registro do Funcionário
   • Lembretes do funcionário
   • Func
   • Inserir saldos iniciais
   • Inserir créditos do fornecedor
   • Registros de patrimônio líquido
   • Estabelecer cotas
   • Estimar
   • Eventos
   • Expense Report
   • Expenses
   • Exportar Listas
   • Dimensão do valor justo
   • Fórmula de valor justo
   • Preço de valor justo
   • Demonstrativos Financeiros
   • Localizar transação
   • Registros de ativo fixo
   • Atender pedidos
   • Solicitação de atendimento
   • General Ledger
   • Gerar Listas de Preços
   • Gerar Instruções
   • Despesas de funcionários importadas
   • Remessa de Entrada
   • Receita
   • Demonstrativo de receita
   • Estoque
   • Alteração de Status de Estoque
   • NFF
   • Aprovação da NFF
   • Faturar pedidos de venda
   • Atendimento do Item
   • Recebimento do Item
   • Categoria de Receita do Item
   • Itens
   • Instantâneo/lembretes do lead
   • Localizações
   • Registros de passivo de longo prazo
   • Efetuar Lançamento
   • Gerenciar Períodos Contábeis
   • Gerenciar Folha de Pagamento
   • Atualizações em Massa
   • Transações memorizadas
   • Acesso ao Dispositivo Móvel
   • Patrimônio Líquido
   • Registros sem contabilização
   • Guia Observações
   • Oportunidade
   • Outros registros de ativos
   • Outros registros de ativo circulante
   • Outros registros de passivo circulante
   • Outras listas
   • Outros Nomes
   • Transferência de propriedade
   • Pagar faturas
   • Pagar imposto sobre vendas
   • Pagar obrigação fiscal
   • Lançamento de contracheque
   • Itens de folha de pagamento
   • Executar Pesquisa
   • Chamadas Telefônicas
   • Enviar variações de fatura de fornecedor
   • Período contábil em transações
   • Catálogos de Preços
   • Planos de preços
   • Processar Folha de Pagamento
   • Regras de receita do projeto
   • Contrato de Compra
   • Ordem de Compra
   • Relatórios da Ordem de Compra
   • Compras
   • Conciliar
   • Reconciliar Relatórios
   • Reembolsar devoluções
   • Personalização do Relatório
   • Programação do Relatório
   • Solicitação de Cotação
   • Requisição
   • Recurso
   • Autorização de Devolução
   • Reavaliar custo de estoque
   • Contrato de Receita
   • Aprovação de contrato de receita
   • Elemento de Receita
   • Mapeamento de campos de reconhecimento de receita
   • Plano de reconhecimento de receita
   • Relatórios de reconhecimento de receita
   • Regra de Reconhecimento de Receita
   • Tabelas de reconhecimento de receita
   • Web Services SOAP
   • Vendas
   • Vendas por parceiro
   • Vendas por promoção
   • Ordem de Venda
   • Aprovação da Ordem de Venda
   • Relatórios de atendimento de pedidos de venda
   • Relatórios de Ordem de Venda
   • Relatório de Transação de Ordem de Venda
   • Configurar orçamentos
   • Configurar web services SOAP
   • Encargo do Demonstrativo
   • Registros de conta estatística
   • Atendimento de Retirada na Loja
   • Pedidos de alteração de assinatura
   • Plano de assinatura
   • Inscrições
   • Subsidiárias
   • SuiteAnalytics Connect
   • SuiteAnalytics Pasta de Trabalho
   • Tarefas
   • Tax
   • Rastrear Mensagens
   • Detalhe da Transação
   • Transferir Fundos
   • Transferir Equipamento
   • Ordem de Transferência
   • Aprovação de Ordem de Transferência
   • Balancete
   • Registros de contas a receber não faturados
   • Desmontagens
   • Unidades
   • Aprovação de fatura do fornecedor
   • Aprovação de pagamento do fornecedor
   • Solicitação de orçamento do fornecedor
   • Autorização de devolução ao fornecedor Approval
   • Autorização de Devolução do Fornecedor
   • Devoluções do Fornecedor
   • Fornecedores
   • Calendário de Trabalho
   • Ordem de Serviço
   • Fechamento da Ordem de Trabalho
   • Conclusão da Ordem de Serviço
   • Emissão da Ordem de Trabalho
5. Adicione a permissão SuiteAnalytics Connect – Ler tudo.

   Clique na aba Configuração na aba Permissões, selecione SuiteAnalytics Connect – Ler tudo no menu suspenso e clique em Adicionar.

6. Clique em Salvar para aplicar essas permissões à função personalizada.
7. Atribua a atribuição personalizada a um usuário. Ao criar uma conexão com NetSuite no Data Transforms, você precisará informar as credenciais desse usuário para estabelecer conexão com o servidor de dados. Consulte Como criar a conexão do Oracle NetSuite para obter informações sobre como criar a conexão.

   Para atribuir a função personalizada ao usuário, vá para Configuração > Usuários / funções > Gerenciar usuários. Clique em Editar ao lado do nome do usuário, designe a função personalizada e clique em Salvar.

8. Para verificar as permissões de acesso, faça login como o usuário que tem o papel personalizado atribuído.

   Vá para Analytics > Conjuntos de Dados. Clique em Novo Conjunto de Dados. Esta página listará todas as tabelas e tipos de registro aos quais o usuário tem acesso. Procure a tabela "transação", por exemplo, para verificar se o usuário tem acesso à tabela de transação.

Criação da conexão do Oracle NetSuite

Você pode criar uma conexão do Oracle NetSuite usando conectividade JDBC ou autenticação OAuth 2.0.

Para definir uma conexão do Oracle NetSuite:

1. No painel esquerdo da Home page, clique na guia Conexões.

   A página Connections é exibida.

2. Clique em Criar Conexão.

   A página Criar Conexão é apresentada.

3. Execute um dos seguintes procedimentos:
   • No campo Selecionar Tipo, informe o nome ou parte do nome do tipo de conexão.
   • Selecione a guia Aplicativos.
4. Selecione Oracle NetSuite como o tipo de conexão.
5. Clique em Próximo.
6. O campo Nome da Conexão é pré-preenchido com um nome padrão. Você pode editar esse valor.
7. Para especificar os detalhes da conexão, execute um dos seguintes procedimentos:
   • Para usar a conectividade JDBC, especifique os seguintes detalhes:
     • URL do JDBC - Digite a URL do servidor do SuiteAnalytics Connect a ser usado para a conexão.
     • Usuário - Informe o nome do usuário para conexão com o servidor de dados.
     • Na caixa de texto Senha, informe a senha para se conectar ao servidor de dados.
     • Na caixa de texto ID da Conta, informe o ID da conta para conexão com o servidor de dados.
     • Na caixa de texto ID da Atribuição, informe o ID da atribuição para estabelecer conexão com o servidor de dados.
   • Para usar a autenticação OAuth 2.0, clique na opção OAuth 2.0 e especifique os seguintes detalhes:
     • Nome do Usuário - Informe o nome do usuário que tem acesso de atribuição para fazer log-in no NetSuite usando a conexão OAuth 2.0. Este é o usuário ao qual você designou a função personalizada em Configurando Permissões de Acesso Necessárias para Criar Data Warehouse.
     • ID da Conta - Informe o ID da conta para estabelecer conexão com o servidor de dados. Você pode obter essas informações fazendo log-in na conta NetSuite e exibindo as informações de conexão SuiteAnalytics.
     • ID da Atribuição - Informe o ID da atribuição para estabelecer conexão com o servidor de dados. Você pode obter essas informações fazendo log-in na conta NetSuite e exibindo as informações de conexão SuiteAnalytics.
     • ID do Cliente - Informe o ID do cliente para estabelecer conexão com o servidor de dados.

       Para obter o ID do cliente, crie um registro de Integração em NetSuite ativando o Fluxo de Credenciais do Cliente OAuth 2.0. Copie e salve o ID do cliente exibido quando o registro de integração for criado com êxito.

       Observação
       
       O NetSuite não suporta mais o esquema RSA PKCSv1.5 para assinatura de token para o fluxo de credenciais do cliente NetSuite OAuth 2.0. Todas as integrações que dependem do esquema RSA PKCSv1.5 precisarão ser atualizadas para usar o esquema RSA-PSS. Consulte a documentação do Oracle NetSuite para obter mais informações.
     • Certificado Público e Chave Privada - Use os comandos OpenSSL para gerar o par de chaves no formato PEM necessário. Por exemplo,

       openssl req -new -x509 -newkey rsa:4096 -keyout private.pem -sigopt rsa_padding_mode:pss -sha256 -sigopt rsa_pss_saltlen:64 -out public.pem -nodes -days 365

       Cole o conteúdo de public.pem no campo Certificado Público. Cole o conteúdo de private.pem no campo Chave Privada.

     • ID do Certificado - Informe o ID do Certificado para estabelecer conexão com o servidor de dados.

       Para obter o ID do certificado, use a Configuração de Credenciais do Cliente NetSuite OAuth 2.0 (M2M) para adicionar o arquivo de certificado público (auth-cert.pem) à lista de chaves de certificado e copiar o ID do Certificado gerado.

8. Se a origem que você deseja usar para mapeamento for uma pesquisa salva, especifique também os seguintes detalhes em Extração da Pesquisa Salva:
   • ID do Aplicativo: Informe o ID do Aplicativo NetSuite para Transformações de Dados.
   • Versão: Informe o número da versão NetSuite.
9. Marque a caixa de seleção em Criar Modelo de Dados para instalar fluxos de dados e workflows pré-criados que você pode executar para extrair dados de NetSuite e movê-los para seu esquema de destino da Oracle usando o assistente de Criação de Data Warehouse.
10. Clique em Testar Conexão para testar a conexão estabelecida.
11. Depois de fornecer todos os detalhes de conexão necessários, clique em Criar.

    A nova conexão foi criada.

As novas conexões são exibidas na página Connections.

Clique no ícone Ações () ao lado da conexão selecionada para executar as seguintes operações:

• Selecione Editar para editar os detalhes fornecidos da conexão.
• Selecione Test Connection para testar a conexão criada.
• Selecione Criar Data Warehouse para selecionar as áreas funcionais e criar o Data Warehouse NetSuite no esquema de destino. Consulte Usando o Assistente de Criação de Data Warehouse para obter mais informações.
• Clique em Exportar para exportar a conexão. Consulte Exportar Objetos.
• Selecione Excluir Esquema para excluir o esquema.
• Selecione Excluir Conexão para excluir a conexão criada.

Você também pode procurar a Conexão necessária para saber seus detalhes com base nos seguintes filtros:

• Nome da Conexão.
• Tecnologia associada à Conexão criada.

Usando o Assistente de Criação de Data Warehouse

Os dados em sua conta NetSuite são agrupados em áreas de negócios ou de assunto no Analytics Warehouse. O assistente de Criação de Data Warehouse permite selecionar as áreas que você deseja incluir no Data Warehouse recém-criado.

Para usar o Assistente de Criação de Data Warehouse:

1. Na página inicial, clique na guia Connections. A página Connections é exibida.
2. Clique no ícone Ações () ao lado da conexão do Oracle NetSuite que você deseja usar para criar o data warehouse e clique em Criar Data Warehouse.

   O assistente Criar Data Warehouse é aberto.

3. Na lista drop-down Conexão, escolha a conexão do Autonomous Database na qual seu esquema de destino reside.
4. Na lista drop-down Esquema de Tabela Intermediária, todos os esquemas correspondentes à conexão selecionada são listados em dois grupos:
   • Esquema Existente (que você importou para o Oracle Data Transforms) e
   • Novo Esquema de Banco de Dados (que você ainda não importou).
   Selecione o esquema que você deseja usar na lista drop-down.
5. Da mesma forma, selecione o Esquema de Destino.
6. Clique em Próximo.
7. Selecione as NetSuite Áreas de Negócios que você deseja usar para transferir dados do Data Warehouse NetSuite para o esquema de destino.
8. Clique em Salvar.

   O Data Transforms inicia o processo de criação do data warehouse. Clique em Jobs no painel esquerdo da Home page para monitorar o andamento do processo. Quando o job é concluído com sucesso, o Data Transforms cria uma pasta do Projeto que inclui todos os fluxos de trabalho e fluxos de dados pré-criados, que você pode executar para transferir dados da conexão NetSuite para seu esquema de destino. Consulte Executando os Workflows Predefinidos para Carregar Dados no Esquema de Destino para obter mais informações.

Executando os Fluxos de Trabalho Predefinidos para Carregar Dados no Esquema de Destino

Quando o assistente de Criação de Data Warehouse é concluído com sucesso, o Data Transforms cria um projeto que inclui todos os fluxos de dados e workflows pré-criados que você pode executar para extrair dados de uma conexão NetSuite e carregá-los no seu esquema de destino.

Para exibir e executar os fluxos de trabalho predefinidos:

1. Clique em Projetos no painel esquerdo da Home page e selecione o projeto NetSuite recém-criado.
2. Clique em Workflows no painel esquerdo. Os seguintes fluxos de trabalho pré-criados são listados na página Detalhes do projeto:
   • Preparar Origem NetSuite para SDS
   • Extrair Transação - Chaves Primárias
   • Carregar SDS para Depósito
   • Aplicar Exclusões
   • Todos os Workflows
3. Clique no ícone Ações () ao lado do workflow que deseja executar e clique em Iniciar.

   A Oracle recomenda que você execute Todos os Workflows para executar todos os workflows pré-criados.

   Para ver o status do workflow, clique em Jobs no painel esquerdo do projeto atual. Quando o job é concluído com sucesso, todos os dados da conexão NetSuite são carregados no esquema de destino.

O recurso de pontos finais dedicados do OCI Object Storage permite que os clientes do OCI acessem com segurança os buckets de armazenamento. Consulte Pontos Finais Dedicados do Serviço Object Storage para obter mais informações. Você precisa usar o novo formato de URL ao criar conexões do serviço Object Storage no Data Transforms. Para usuários que já têm uma conexão do Object Storage, o URL existente é atualizado automaticamente para o novo formato de URL.

Para criar uma conexão do Oracle Object Storage, você precisa ter um nome de usuário e um token de autenticação do Oracle Cloud Infrastructure. Consulte Obtendo um Token de Autenticação para obter informações sobre como gerar o token de autenticação. Você precisa especificar esses detalhes ao definir a conexão no Oracle Data Transforms.

Observe o seguinte:

• Para usar uma conexão do Oracle Object Storage para importar dados para o Data Transforms, use um endereço IP público para acessar o nó de computação. Se você quiser usar um endereço IP privado para acessar o serviço Object Storage, certifique-se de ter acesso à Internet.
• O formato de arquivo suportado para carregar dados do Oracle Object Storage para o Autonomous Database e vice-versa é CSV.
• Os tipos de dados suportados são Numérico, Duplo, String e Data.
• Não há suporte para carga de dados nas conexões do Oracle Object Storage.
• Para criar um mapeamento para o serviço Object Storage, a tecnologia de origem deve suportar o pacote DBMS_CLOUD. Caso contrário, o mapeamento falhará.
• As Transformações de Dados não suportam conectividade entre domínios para o Object Storage. Por exemplo, você não pode estabelecer conexão de Transformações de Dados configuradas em uma região do Cloud do Setor Governamental com o Object Storage que esteja em um realm comercial.

Para definir uma conexão do Oracle Object Storage,

As novas conexões são exibidas na página Connections.

Clique no ícone Ações () ao lado da conexão selecionada para executar as seguintes operações:

• Selecione Editar para editar os detalhes de conexão fornecidos.
• Selecione Testar Conexão para testar a conexão criada.
• Clique em Exportar para exportar a conexão. Consulte Exportar Objetos.
• Selecione Excluir Esquema para excluir esquemas.
• Selecione Excluir Conexão para excluir a conexão criada.

Você também pode procurar a Conexão necessária para saber seus detalhes com base nos seguintes filtros:

• Nome da Conexão.
• Tecnologia associada à Conexão criada.

Para criar um conector REST genérico, forneça o URL JDBC, o nome de usuário e a senha para estabelecer conexão com o ponto final. Você também pode criar e fazer upload de um arquivo de configuração que contenha informações como métodos de autenticação, pontos finais e tabelas das quais você deseja importar entidades de dados.

• Criando uma Conexão REST Genérica
• Criando uma Conexão Rest Genérica Usando um Arquivo de Configuração

As conexões criadas recentemente são exibidas na página Conexões.

Clique no ícone Ações () ao lado da conexão selecionada para executar as seguintes operações:

• Selecione Editar para editar os detalhes da conexão fornecidos.
• Selecione Testar Conexão para testar a conexão criada.
• Clique em Exportar para exportar a conexão. Consulte Exportar Objetos.
• Selecione Excluir Esquema para excluir esquemas.
• Selecione Excluir Conexão para excluir a conexão criada.

Você também pode procurar a conexão necessária para saber seus detalhes com base nos seguintes filtros:

• Nome da conexão.
• Tecnologia associada à conexão criada.

Criando uma Conexão REST Genérica

Para criar essa conexão, você precisa especificar o URL do serviço REST e escolher um esquema temporário em que o Data Transforms possa criar entidades de dados após a operação de engenharia reversa.

Para definir uma conexão de servidor REST:

1. No painel esquerdo da Home page, clique na guia Conexões.

   A página Conexões é exibida.

2. Clique em Criar Conexão.

   Os slides da página Criar Conexão.

3. Execute um dos seguintes procedimentos:
   • No campo Selecionar Tipo, informe o nome ou parte do nome do tipo de conexão.
   • Selecione a guia Aplicativos.
4. Selecione Rest Genérico como o tipo de conexão.
5. Clique em Próximo.
6. O campo Nome da Conexão é pré-preenchido com um nome padrão. Você pode editar esse valor.
7. Na caixa de texto URL do Serviço REST, informe o URL do ponto final que atende aos recursos REST.
8. Na caixa de texto Host Proxy, informe o nome do host do servidor proxy a ser usado para a conexão.
9. Na caixa de texto Porta do Proxy, informe o número da porta do servidor proxy.
10. Na caixa de texto Usuário, informe o nome do usuário para conexão ao ponto final REST.
11. Na caixa de texto Senha, informe a senha para estabelecer conexão com o ponto final REST.
12. Escolha uma conexão na lista drop-down Conexão Intermediária. A lista exibe apenas conexões existentes do Autonomous Database. Para usar uma conexão diferente, crie a conexão antes de acessar esta página.
13. Após fornecer todos os detalhes necessários da conexão, clique em Testar Conexão para testar a conexão.
14. Clique em Criar.

    A nova conexão foi criada.

Criando uma Conexão Rest Genérica Usando um Arquivo de Configuração

APLICA-SE A: Data Transforms que está disponível como uma listagem separada no Marketplace chamada Data Integrator: Web Edition.

Para criar um conector REST genérico, você precisa do URL JDBC, do nome de usuário, da senha e de um arquivo de configuração. O arquivo de configuração é um arquivo de modelo com a convenção de nomenclatura file_name.rest que você precisa fazer upload ao criar uma conexão do Servidor REST. Você precisa especificar os pontos finais, mapeamentos de tabela e os métodos de autenticação para criar o arquivo de configuração. É possível criar o arquivo de configuração usando qualquer editor de texto.