Documentação do Oracle Cloud Infrastructure

Carregar Dados do Oracle Object Storage Service no Fusion Data Intelligence

Como administrador de serviços, você pode usar o serviço de extração do Fusion Data Intelligence para adquirir dados do Oracle Object Storage Service e usá-lo para criar aumentos de dados.

A abordagem recomendada é criar um aumento de uma tabela de origem após a aquisição de dados do Oracle Object Storage Service. Após a conclusão do aumento, o Fusion Data Intelligence renomeará a tabela de origem nesse caso e se você criar mais de um aumento com base na mesma origem, todos os outros aumentos poderão falhar com uma mensagem de que o arquivo de origem não foi encontrado.

  1. Armazene os seguintes detalhes em um arquivo de texto a ser usado ao criar a conexão com o Oracle Object Storage Service no Fusion Data Intelligence:
    1. No Oracle Object Storage Service, crie o diretório Arquivos de Extração do Host Remoto como a pasta base na qual você deve colocar todos os seus arquivos de dados. Anote o nome deste diretório. Consulte a seção "Para criar uma pasta ou subpasta" em Usando a Console.
    2. Obtenha o URL do Oracle Object Storage Service acessando a Console do Oracle Cloud Infrastructure e navegando até o bucket para obter os detalhes da região, do namespace e do nome do bucket. Por exemplo, o URL deve estar no formato https://objectstorage.<region>.oraclecloud.com/n/<namespace>/b/<name of the bucket>. Consulte a seção "Para exibir detalhes do bucket" em Usando a Console.
    3. Obtenha o OCID de um usuário navegando na Console do Oracle Cloud Infrastructure até Identidade e Segurança e, em seguida, Usuários. Na página Usuários, procure um usuário que tenha acesso ao bucket usado no conector e copie o OCID. Obtenha o ID da tenancy clicando no ícone do seu perfil e depois em Tenancy na Console do Oracle Cloud Infrastructure. Em Informações da Tenancy, copie o OCID. Consulte Onde Obter o OCID da Tenancy e o OCID do Usuário.
    4. Obtenha a impressão digital de um usuário na Console do Oracle Cloud Infrastructure. Navegue até Chaves de API em Recursos na página do usuário e clique em Adicionar Chaves de API. Na caixa de diálogo Adicionar Chaves de API, certifique-se de que Gerar Par de Chaves de API esteja selecionado. Faça download das chaves privadas e públicas usando as opções Fazer Download da Chave Privada e Fazer Download da Chave Pública. Você deve copiar o texto inteiro da chave privada junto com os comentários antes e depois da chave real. Estes comentários podem ser tão simples como: "---------------Begin RSA Private Key --------" e "-----------End of RSA Private Key----------". Não copie apenas a chave alfanumérica sem os comentários do cabeçalho e do rodapé. No diálogo Adicionar Chaves de API, selecione Escolher Arquivo de Chave Pública para fazer upload de seu arquivo ou Colar Chave Pública, se preferir colá-lo em uma caixa e, em seguida, clique em Adicionar. Copie a impressão digital que você vê após fazer upload da chave pública na Console. Ele é semelhante a este:12:34:56:78:90:ab:cd:ef:12:34:56:78:90:ab:cd:ef.
  2. No Fusion Data Intelligence, crie a conexão do Oracle Object Storage usando estas instruções:
    1. Na Console do Fusion Data Intelligence, clique em Configuração de Dados em Administração de Aplicativos.
    2. Na página Configuração de Dados, clique em Gerenciar Conexões.
    3. Na página Gerenciar Conexões, clique em Criar e em Conexão.
    4. Em Criar Conexão, selecione Extração de Dados em Tipo de Uso e, em seguida, selecione Oracle Object Storage Service como tipo de conexão.
      Opção de conexão do Oracle Object Storage Service
    5. Na caixa de diálogo da conexão do Oracle Object Storage Service, selecione Padrão em Tipo de Conectividade e informe estes detalhes:
      • Nome da Conexão: Object Storage
      • Tipo de Conexão: Padrão
      • E-mail de Notificação: Um endereço de e-mail para receber notificações
      • Diretório de Arquivos de Extração de Host Remoto: Nome da pasta base na qual você deve colocar todos os seus arquivos de dados no Oracle Object Storage Service
      • URL: URL do Oracle Object Storage Service que você anotou em um arquivo de texto
      • ID do Usuário: O OCID de um usuário que tem acesso ao bucket aplicável no Oracle Object Storage Service
      • Impressão Digital: A impressão digital que você viu e copiou após o upload da chave pública na Console. Parece ser este: 12:34:56:78:90:ab:cd:ef:12:34:56:78:90:ab:cd:ef
      • ID do Tenant: Tenancy na Console do Oracle Infrastructure Cloud que você anotou no arquivo de texto
      • Chave Privada: Cole o conteúdo da chave privada que você baixou anteriormente
      • Tipo de Arquivo: csv
      • Delimitador CSV: Delimitador dos arquivos de dados
      • O formato de data dos arquivos de dados deve corresponder ao formato de data na origem do Oracle Object Storage Service; por exemplo, se você tiver usado MM/dd/yyyy (23/01/1998) na origem, deverá especificar o mesmo formato em Formato de Data CSV. Consulte Sobre Formatação de Data e Timestamp para Extratores Baseados em Arquivo CSV.
      • O formato de timestamp dos arquivos de dados deve corresponder ao formato de timestamp na origem do Oracle Object Storage Service; por exemplo, se você tiver usado MM/dd/yyyy hh:mm:ss (23/01/1998 12:00:20) na origem, deverá especificar o mesmo formato em Formato de Timestamp CSV
      Caixa de diálogo Criar Conexão para o Oracle Object Storage Service
    6. Verifique se a alternância Atualizar Metadados está ativada para garantir que os metadados sejam atualizados quando você salvar a conexão.
      Posteriormente, você poderá atualizar os metadados no menu Ações da página Gerenciar Conexões, se necessário.
      Observação

      Você não pode criar aumentos para o Oracle Object Storage Service, a menos que execute uma extração de metadados.
    7. Clique em Salvar.
  3. No Oracle Object Storage Service:
    1. Crie a estrutura de pastas no Bucket usando estas diretrizes:
      Pasta base
      • A pasta base no bucket deve corresponder aos detalhes fornecidos na conexão.
      • Dentro da pasta base, certifique-se de colocar cada arquivo em sua própria pasta.
      • Certifique-se de que o Prefixo de Data_Store_Name (igual ao nome da Pasta) e os Arquivos na pasta de destino correspondam exatamente.

      Consulte a seção "Para criar uma pasta ou subpasta" em Usando a Console.

    2. Dentro da pasta base, crie o arquivo de metadados para a Lista de Armazenamento de Dados. Esse arquivo lista os armazenamentos de dados suportados. Cada armazenamento de dados é uma pasta que tem o arquivo real usado no aumento de dados, por exemplo, ASSETS. Verifique se o nome do arquivo e o nome da pasta correspondem e se não há caracteres especiais (incluindo espaço) no armazenamento de dados, pasta ou nomes de arquivo.
      Estrutura da pasta base
    3. Crie o arquivo de metadados para cada arquivo de dados na pasta de armazenamento de dados usando estas diretrizes:

      O META_DATASTORES.csv deve ter estas colunas:

      • DATA_STORE_NAME - Uma coluna obrigatória para identificar o nome do armazenamento de dados.
      • DATA_STORE_LABEL - Uma coluna não obrigatória que identifica a descrição do armazenamento de dados.
      Observação

      Se você adicionar novos armazenamentos de dados a uma conexão de origem existente, certifique-se de que META_DATASTORES.csv contenha a lista completa de armazenamentos de dados, incluindo os armazenamentos de dados existentes mais antigos.

      Cada pasta deve ter:

      • Um arquivo de dados que tem os dados reais que são carregados no Fusion Data Intelligence. Este arquivo deve ter um prefixo com DATA STORE NAME.
      • Um arquivo de metadados para a lista de colunas contém todas as informações da coluna nos dados. Esse arquivo deve ter um Prefixo com META_DATASTORES_<DATA_STORE_NAME>_COL.
        • Para as colunas desses metadados, verifique o seguinte:
        • Se o nome da coluna for ABC, os metadados poderão ser ABC ou "ABC" - as aspas duplas serão ignoradas.
        • Se o nome da coluna for "ABC", os metadados deverão ser ""ABC"" – as primeiras aspas duplas serão ignoradas.

      Exemplo

      Na imagem, o nome da pasta é ACTIVITY_TYPES. Portanto, o nome do armazenamento de dados é ACTIVITY_TYPES. Você pode confirmar isso no arquivo META_DATASTORES.csv. Neste exemplo, o arquivo é chamado ACTIVITY_TYPES.xlsx ou ACTIVITY_TYPES.csv. O arquivo de metadados deve ser META_DATASTORES_ACTIVITY_TYPES_COL.csv.Amostra de pasta e arquivo de metadados

      O META_DATASTORES_ACTIVITY_TYPES_COL.csv tem estas colunas:
      • DATA_STORE_NAME - Esta é uma coluna obrigatória.
      • COLUMN_NAME - Esta é uma coluna obrigatória.
      • COLUMN_LABEL - Esta é uma coluna não obrigatória.
      • DATA_TYPE – Esta é uma coluna obrigatória.
      • WIDTH – Esta coluna identifica o comprimento da string.
      • PRECISÃO - Este valor de coluna deve ser do tipo de dados Numérico.
      • ESCALA - Este valor de coluna deve ser um tipo de dados numérico.
      • KEY_SEQUENCE - Esta é uma coluna obrigatória que identifica a definição da Chave Primária. Se você estiver usando a chave primária composta, use números de ordem das colunas como valores.
  4. No Fusion Data Intelligence, na página Gerenciar Conexões, selecione Ações para a conexão do Oracle Object Storage Service e selecione Testar Conexão.
  5. Para deletar uma conexão, na página Gerenciar Conexões, clique em Ações da conexão aplicável e selecione Excluir.
    Observação

    Certifique-se de excluir as áreas funcionais, os aumentos de dados e as configurações de dados personalizadas relacionadas à conexão de dados antes de excluí-la. Não é possível atualizar ou carregar dados de conexões de dados excluídas para o warehouse.
  6. Após o estabelecimento bem-sucedido das conexões, navegue até a página Configuração de Dados, selecione a conexão em Origem de Dados, clique no mosaico Aumento de Dados e crie um aumento de dados usando os dados do Oracle Object Storage Service. Selecione as tabelas de origem aplicáveis nos dados do Oracle Object Storage Service. Consulte Aumente seus dados.