Documentação do Oracle Cloud Infrastructure

Trabalhar com Entidades de Dados

Entidade de Dados é uma representação tabular de uma estrutura de dados.

Ela inclui Tabelas ou Views de Banco de Dados que podem ser usadas em um mapeamento como origem ou destino. São simplesmente os metadados de origens e destinos. São usados na criação de fluxos de dados.

Você pode adicionar Entidades de Dados ao seu projeto recém-criado de uma destas duas maneiras:

Todas as Entidades de Dados criadas ou importadas com seus detalhes são exibidas na página Entidades de Dados. Os detalhes incluem:

  • Nome da Entidade de Dados
  • conexão cuja Entidade de Dados foi criada.
  • Esquema ao qual a Entidade de Dados está associada
  • Clique no ícone Ações (ícone Ações) ao lado da Entidade de Dados selecionada para executar as seguintes operações:
    • Selecione Editar para editar os detalhes existentes.
    • Selecione Exibir para visualizar a Entidade de Dados selecionada. Se a entidade de dados pertence a um banco de dados Oracle, você também pode exibir estatísticas da tabela. Consulte Exibir Estatísticas de Entidades de Dados para obter mais detalhes.
    • Selecione Excluir para excluir a Entidade de Dados selecionada.
  • Para excluir as entidades de dados em massa, na página Entidades de Dados, marque as caixas de seleção das respectivas entidades de dados e clique em Excluir.
  • Você também pode procurar a Entidade de Dados obrigatória para saber seus detalhes com base nos seguintes filtros:
    • Nome da Entidade de Dados
    • conexão cuja Entidade de Dados foi criada.
    • Esquema ao qual a Entidade de Dados está associada
    • Tag associada à Entidade de Dados

Tópicos

Tópico pai: Página Transformações de Dados

Importar entidades de dados

A maneira mais fácil e comum de criar uma Entidade de Dados é importando sua estrutura do tipo de conexão (por exemplo, banco de dados Oracle).

Para importar Entidades de Dados existentes:

  1. No painel esquerdo da Home page, clique na guia Entidades de Dados.

    A página Entidades de Dados é exibida.

  2. Clique em Importar Entidades de Dados para importar as entidades de dados existentes.

    Slides da página Importar Entidades de Dados. Se você planeja usar uma conexão do Oracle ERP Cloud Server para a importação, consulte Importando Definições de Entidade de Dados de um Oracle ERP Cloud Server.

  3. Selecione a Conexão seguida de Esquema e, em seguida, finalmente selecione o Tipo de Objetos que deseja importar.

    Para conexões do Oracle Object Storage, a lista drop-down Esquema lista o nome do bucket que você especificou no URL quando criou a conexão.

  4. [Somente para conexões do Oracle Business Intelligence Cloud Connector (BICC)] Nas Ofertas a serem importadas para coleta, escolha as ofertas cujos armazenamentos de dados você deseja importar. Selecione pelo menos uma oferta para importar os objetos de view pública (PVO) do BICC.
    Observação

    A importação de PVOs BICC pode levar muito tempo, dependendo do número de objetos selecionados. Para melhorar o desempenho, a Oracle recomenda que você use uma máscara para filtrar e limitar o número de PVOs que deseja importar.
  5. Escolha uma Masca/filter se não quiser importar cada objeto no esquema.

    Dependendo do Tipo de Conexão, serão apresentadas mais opções de importação.

    Observação

    Para conexões do Oracle Object Storage, esse valor faz distinção entre maiúsculas e minúsculas. Se a opção Arquivos semelhantes em batch for definida como True, todos os arquivos que corresponderem à máscara e tiverem a mesma estrutura serão agrupados em uma única entidade de dados.
  6. [Somente para conexões do Oracle Financials Cloud] Na lista da seção Recursos, selecione os itens que você deseja importar. Quando o processo de importação for concluído, uma tabela será criada para cada recurso selecionado.
  7. [Somente para conexões do servidor REST] Na seção Recursos, faça o seguinte:
    • No campo URI do Recurso, digite o URL do serviço REST do qual você deseja importar recursos.
    • Clique no ícone +
    • Na coluna Nome, informe um identificador para o recurso.
    • Na coluna URI da Operação, informe o URI do recurso.
    • Clique em Testar Recurso para verificar se as entradas são válidas.
  8. Clique em Iniciar.

    Um Job é criado e o ID do Job correspondente é exibido para você rastrear a sessão. Clique no ID do Job para exibir os detalhes do job.

    Após a execução bem-sucedida do job, todas as Entidades de Dados selecionadas são importadas. Clique no ícone Atualizar ícone Atualizar presente no canto direito da página Entidades de Dados para ver as novas Entidades de Dados importadas.

Criar Entidades de Dados

Você pode criar ou atualizar manualmente as Entidades de Dados por meio da interface do Oracle Data Transformas.

As entidades de dados devem ter os objetos correspondentes na conexão de origem a serem usados como origem em um fluxo de dados. Normalmente, o processo de importação garante que esses objetos estejam coordenados. No entanto, sempre que você criar ou atualizar manualmente Entidades de Dados, sempre certifique-se de verificar se ambas as definições estão coordenadas entre si.

Quando você usa uma Entidade de Dados como destino, ela não precisa existir anteriormente na conexão de destino e pode ser criada como parte da execução do Fluxo de Dados.

Para criar uma nova Entidade de Dados:
  1. No painel esquerdo da Home page, clique na guia Entidades de Dados.

    A página Entidades de Dados é exibida.

  2. Clique em Criar Entidade de Dados para criar uma nova entidade de dados.

    A página Criar Entidade de Dados é exibida.

  3. Na caixa de texto Nome, digite o nome da nova Entidade de Dados que você está criando.
  4. Na lista drop-down conexão, selecione a conexão necessária da qual você deseja adicionar a Entidade de Dados recém-criada.
    Observação

    As conexões do Oracle Financials Cloud não são listadas aqui porque você não pode criar entidades de dados manualmente para essas conexões. Você só pode importar entidades de dados de pontos finais REST do Oracle Financials Cloud usando a página Importar Entidade de Dados. Consulte Importar Entidades de Dados.
  5. Na lista drop-down Esquema, todos os esquemas correspondentes à conexão selecionada são listados em dois grupos.
    • Novo Esquema de Banco de Dados (que você não importou anteriormente) e
    • Esquema de Banco de Dados Existente (que você importou anteriormente e está potencialmente substituindo entidades de dados).

    Na drop-down Esquema, selecione o esquema necessário.

    Observação

    Para conexões do Oracle Object Storage, a lista drop-down Esquema mostra o nome do bucket especificado no URL quando você criou a conexão.
  6. No menu suspenso Tipo, selecione o tipo de entidade de dados.
    • Tabela: Para definir a estrutura da tabela para a Entidade de Dados recém-criada, clique no ícone + para adicionar colunas. Para cada coluna, você pode especificar parâmetros como Nome, Tipo de Dados, Tamanho, Escala, Não Nulo. Clique duas vezes na célula para configurar o valor.

      Clique no ícone 'x' para excluir uma linha. Clique nas setas para cima e para baixo para classificar as linhas da tabela.

    • View em Linha: Para criar a entidade de dados usando o código em linha, informe a instrução Select na guia Consulta. Por exemplo, SELECT * FROM CUSTOMER. Clique em Validar.

      A guia Colunas exibe uma lista somente leitura das colunas que a consulta retorna. Clique na guia Visualizar para ver os dados da coluna.

  7. Na caixa de texto Tags, digite uma tag de sua escolha. Você pode usar tags para filtrar as entidades de dados exibidas na página Entidade de dados.
  8. Para conexões do Oracle Object Storage, esta página exibe as seguintes opções:
    • Conteúdo - Selecione o arquivo CSV que contém os dados que você deseja importar. Os metadados exibidos na tabela de visualização, como o tipo de dados e o tamanho das colunas, são baseados na primeira linha do arquivo CSV. Verifique se o arquivo CSV tem uma linha de cabeçalho. O cabeçalho deve conter apenas caracteres alfanuméricos e nenhum caractere especial.
    • Arquivos de Grupo - Marque essa caixa de seleção se desejar agrupar dados de vários arquivos CSV em uma entidade de dados. Por exemplo, digamos que você queira mesclar dados de Employee_Data1.csv, Employee_Data2.csv e Employee_Data3.csv em uma única entidade de dados.

      Se você quiser fazer upload dos arquivos CSV usando o Windows, certifique-se de primeiro converter os arquivos para o formato Unix para evitar problemas de codificação de caracteres durante o agrupamento.

    • Nome do Recurso - Use essa opção junto com Arquivos de Grupo. Digite o valor que você deseja usar para identificar os arquivos. O nome do recurso deve ser uma expressão regular. Você só pode usar um asterisco (*) como caractere curinga no nome do recurso. Por exemplo, Employee_Data*.csv.
  9. Para conexões de banco de dados Oracle, você pode marcar as entidades de dados como grupo de recursos. Expanda Opções Avançadas e clique na caixa de seleção Tratar como Grupo de Recursos.
  10. Clique em Salvar.

    A nova Entidade de Dados é criada.

Criar entidades de dados no editor de fluxo de dados

Se você já tiver criado ou importado sua entidade de dados de destino, arraste a entidade de dados para a Tela de Design e conclua as opções e os mapeamentos de colunas.

Para criar a definição de uma entidade no editor do serviço Data Flow,

  1. Arraste a entidade de dados para a Tela de Design.
  2. Selecione o componente e clique no ícone Adicionar Entidade de Dados Ícone Adicionar Entidade de Dados presente no canto superior direito do componente de destino.
  3. A página Adicionar Entidade de Dados é exibida, permitindo configurar os seguintes detalhes do componente de destino:

    Guia Geral

    • Na caixa de texto Nome, digite o nome da Entidade de Dados recentemente criada.
    • Na lista drop-down Tipo de Entidade, selecione o tipo de entidade de dados.
      • Tabela
      • Modelo de ML
        Quando você seleciona este tipo de entidade, a interface do usuário é alterada da seguinte forma:
        • A lista drop-down Tipo de Conexão lista apenas o Oracle como opção. Consequentemente, a lista drop-down Conexão lista apenas as conexões Oracle que você criou.
        • O assistente Adicionar Entidade de Dados exibe a guia Propriedades, na qual você pode selecionar o Tipo de Aprendizagem, Função, Algoritmo e configurar parâmetros para definir o Modelo de ML. Consulte Usar Modelos de Aprendizado de Máquina (ML) para obter informações detalhadas sobre como criar e usar uma entidade de dados de Modelo de ML.
    • Na lista drop-down Tipo de Conexão, selecione a conexão necessária na qual você deseja adicionar a Entidade de Dados recém-criada. A lista suspensa Conexão é preenchida com as conexões que você criou com o tipo de conexão associado.
    • Na lista drop-down Conexão, selecione o nome do servidor do qual você deseja adicionar a Entidade de Dados recém-criada.
    • Na lista drop-down Esquema, todos os esquemas correspondentes à conexão selecionada são listados em dois grupos.
      • Novo Esquema de Banco de Dados (aqueles dos quais você não importou antes) e
      • Esquema de Banco de Dados Existente (aqueles que você importou de antes e que estão potencialmente substituindo entidades de dados).
      Na drop-down Esquema, selecione o esquema necessário.
      Observação

      Para conexões do Oracle Object Storage, a lista drop-down Esquema lista o nome do bucket que você especificou no URL quando criou a conexão.
    • Na caixa de texto Tags, informe uma tag de sua escolha. Você pode usar tags para filtrar as Entidades de Dados exibidas na Página Entidade de Dados.
    • Para conexões de banco de dados Oracle, você pode marcar as entidades de dados como um grupo de recursos. Expanda Opções Avançadas e clique na caixa de seleção Tratar como Grupo de Recursos.
    • Clique em Próximo.

    Guia Colunas

    • Clique no ícone Ícone Adicionar Colunas Adicionar Colunas para adicionar novas colunas à Entidade de Dados recém-criada.

      Uma nova coluna é adicionada à tabela exibida.

    • A tabela exibe as seguintes colunas:
      • Nome
      • Tipo de Dados - Clique na célula para configurar o Tipo de Dados necessário.
      • Dimensionar
      • Tamanho
      • Ações: clique no ícone cruzado para excluir a coluna criada.
    • Para excluir colunas em massa, selecione as colunas e clique no ícone Ícone Excluir Excluir.
    • Para procurar os detalhes obrigatórios da coluna, na caixa de texto Pesquisar, informe o nome obrigatório da coluna e informe. Os detalhes da coluna obrigatória são exibidos.
    • Clique em Próximo.

    Guia Visualizar Entidade de Dados

    Exibe uma visualização de todas as colunas criadas e seus detalhes configurados. Se a entidade de dados pertence a um banco de dados Oracle, você também pode exibir estatísticas da tabela. Consulte Exibir Estatísticas de Entidades de Dados para obter mais informações.

  4. Clique em Salvar.

    A nova Entidade de Dados de destino é criada.

  5. Expanda o Painel de Propriedades no painel direito para exibir as seguintes definições dos componentes criados:
    • Geral - Exibe o Nome do componente com seus detalhes de Conexão e Esquema.
    • Atributos - Exibe os detalhes de todos os atributos associados ao componente.
    • Mapeamento de Coluna - Clique em Mapear Automaticamente para mapear todas as colunas automaticamente.
    • Visualizar - Clique para ter uma visualização do componente.
    • Opções - Altere as opções conforme apropriado.

Exibir Estatísticas de Entidades de Dados

A guia Visualizar exibe estatísticas detalhadas de cada entidade de dados.

Observação

Esse recurso só está disponível para tabelas do banco de dados Oracle.
Você pode exibir as estatísticas de uma das seguintes maneiras:
  • Na lista Entidades de Dados, clique no ícone Ações (Ícone Ações) ao lado da Entidade de Dados e clique em Exibir. Selecione a guia Estatísticas para exibir as estatísticas da entidade de dados selecionada.
  • Em qualquer fluxo de dados, clique em qualquer entidade de dados de origem ou destino e expanda o painel de propriedades no painel direito. Clique em Exibir.

Os dados estatísticos são apresentados da seguinte forma:

  • O número total de linhas e colunas na entidade de dados é exibido na parte superior.
  • O painel de estatísticas exibe os gráficos em miniatura de cada coluna com informações sobre os valores Min, Max, Distinct e Null.
  • Dois tipos de representações em miniatura são exibidos com base no histograma:
    • Um gráfico de barras representa dados para histogramas de frequência e de frequência superior. O gráfico de barras mostra os primeiros 10 valores principais para o número de linhas na tabela.
    • Uma tabela lista dados para os histogramas Híbrido e Balanceado por Altura. A tabela exibe todos os dados e pode ser rolável. A tabela exibe a faixa dos valores e a porcentagem de linhas em cada faixa.
  • Você pode clicar em cada miniatura para exibir as estatísticas da coluna em uma nova guia do navegador.
  • A view detalhada de cada gráfico também mostra o tipo de histograma.