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. Eles são simplesmente os metadados para origens e destinos. Eles são usados na criação de fluxos de dados.

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

Todas as Entidades de Dados recém-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 para a qual a 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 Visualizar para visualizar a Entidade de Dados selecionada. Se a entidade de dados pertencer a um banco de dados Oracle, você também poderá exibir estatísticas da tabela. Consulte Exibir Estatísticas de Entidades de Dados para obter mais detalhes.
    • Selecione Deletar para excluir a Entidade de Dados selecionada.
  • Para deletar 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 necessária para saber seus detalhes com base nos seguintes filtros:
    • Nome da Entidade de Dados
    • Conexão para a qual a Entidade de Dados foi criada
    • Esquema ao qual a Entidade de Dados está associada
    • Tag que está 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 será 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 Analytics Publisher Server.

  3. Selecione a Conexão seguida de Esquema e, em seguida, selecione finalmente 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)] Em 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 Máscara/filtro se não quiser importar cada objeto no esquema.

    Dependendo do Tipo de Conexão, você verá mais opções para importação.

    Observação

    Para conexões do Oracle Object Storage, esse valor faz distinção entre maiúsculas e minúsculas. Se Arquivos semelhantes em lote estiver definido 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 é concluído, uma tabela é criada para cada recurso selecionado.
  7. [Somente para conexões de servidor REST] Na seção Recursos, faça o seguinte:
    • No campo URI do Recurso, informe 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 Transforms.

As entidades de dados devem possuir os objetos correspondentes na conexão de origem a serem usados como uma origem em um fluxo de dados. Normalmente, o processo de importação garante que esses objetos estejam em coordenação. No entanto, sempre que você criar ou atualizar manualmente Entidades de Dados, certifique-se sempre de verificar se ambas as definições estão em coordenação 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 serviço Data Flow.

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 será 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, informe o nome da nova Entidade de Dados que você está criando.
  4. Na lista drop-down Conexão, selecione a conexão necessária na 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 manualmente entidades de dados para essas conexões. Você só pode importar entidades de dados de pontos finais REST do Oracle Financials Cloud usando a página Importar Entidades 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 (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 lista 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.
  6. Na lista drop-down 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 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, informe 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 quiser 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 carregar os arquivos CSV usando o Windows, certifique-se de converter primeiro os arquivos para o formato Unix para evitar problemas de codificação de caracteres durante o agrupamento.

    • Nome do recurso – Use esta opção junto com Arquivos de grupo. Insira o valor que deseja usar para identificar os arquivos. O nome do recurso deve ser uma expressão regular. Você só pode usar um asterisco (*) como um 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 um 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 do serviço Data Flow

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

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 que você configure os seguintes detalhes do componente de destino:

    Guia Geral

    • Na caixa de texto Nome, informe o nome da Entidade de Dados recém-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 lista 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 de cruz para excluir a coluna criada.
    • Para excluir as colunas em massa, selecione as colunas e clique no ícone Excluir Ícone Excluir.
    • Para pesquisar os detalhes da coluna obrigatória, na caixa de texto Pesquisar, insira o nome da coluna obrigatória e clique em Inserir. Os detalhes da coluna obrigatória são exibidos.
    • Clique em Próximo.

    Guia Visualizar Entidade de Dados

    Ela exibe uma visualização de todas as colunas criadas e seus detalhes configurados. Se a entidade de dados pertencer a um banco de dados Oracle, você também poderá 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 juntamente com seus detalhes de Conexão e Esquema.
    • Atributos - Exibe os detalhes de todos os atributos associados ao componente.
    • Mapeamento de colunas - Clique em Mapa automático 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 de banco de dados Oracle.
Você pode exibir as estatísticas de uma entidade de dados selecionada 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 Visualizar. 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 de destino e expanda o painel de propriedades no painel direito. Clique em Visualizar.

Os dados estatísticos são apresentados do seguinte modo:

  • 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 Mín., Máx., Distinto e Nulo.
  • 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 frequência superior. O gráfico de barras mostra os primeiros 10 principais valores para o número de linhas na tabela.
    • Uma tabela lista dados para histogramas Híbrido e Equilibrado em Altura. A tabela exibe os dados inteiros e é rolável. A tabela exibe o intervalo para os valores e a porcentagem de linhas em cada intervalo.
  • Você pode clicar em cada miniatura para exibir as estatísticas da coluna em uma nova guia do navegador.
  • A visualização detalhada de cada gráfico também mostra o tipo de histograma.