Documentação do Oracle Cloud Infrastructure

Selecionando o Destino de uma Tarefa do Carregador de Dados

Selecione o ativo de dados, a conexão e o esquema a serem usados como destino. Em seguida, configure uma nova entidade de destino ou selecione uma entidade de dados existente para carregar os dados.

Selecionando um Ativo de Dados, uma Conexão e um Esquema de Destino

Para configurar a entidade de dados de destino para uma tarefa do carregador de dados, comece selecionando um ativo de dados, uma conexão e um esquema.

Você pode parametrizar os recursos depois de fazer as seleções.

  1. Na página Criar tarefa do carregador de dados, vá para a etapa Alvo.
  2. Para criar e selecionar o ativo de dados para este destino, selecione Criar ao lado de Ativo de dados para criar um ativo de dados.
  3. Para selecionar uma entidade de dados de destino de um ativo de dados existente, primeiro use os menus de recurso para selecionar o ativo de dados, a conexão e o esquema (ou o bucket) apenas na ordem exibida. Observe as seguintes informações:

    • Os recursos de ativo de dados disponíveis para seleção dependem do tipo de destino que você selecionou na etapa Informações Básicas. Selecione Exibir tudo ao lado de um recurso se não encontrar o que deseja no menu de recursos.

    • Se aplicável a um ativo de dados (por exemplo, Armazenamento de Objetos), selecione um compartimento antes de selecionar um bucket (esquema).

    • Para uma conexão de banco de dados, você pode selecionar Adicionar para criar e adicionar a conexão.

  4. (Opcional) Você pode designar um parâmetro ao ativo de dados, à conexão e ao esquema depois de fazer seleções para os recursos. Execute um dos seguintes procedimentos para um recurso no destino:
    • Selecione Parameterizar ao lado do recurso para designar um parâmetro a esse recurso. Ao parametrizar, o Data Integration adiciona um parâmetro do tipo apropriado e define o valor do parâmetro padrão para o valor que está configurado no momento para esse recurso.
    • Se disponível, selecione Reutilizar parâmetro de origem <resource> para usar o mesmo parâmetro que foi adicionado ao recurso do mesmo tipo na origem. Para obter mais informações, consulte Reutilizando Parâmetros para Recursos de Origem ou de Destino.

    Observe que quando o tipo de ativo de dados é Armazenamento de Objetos, você pode parametrizar o bucket (esquema), mas não o compartimento que contém o bucket.

  5. Dependendo do tipo de ativo de dados de destino, talvez você tenha outras opções para selecionar.
    Tipo de ativo de dados Opção

    Object Storage, HDFS

    Em Definições de arquivo, selecione o tipo de arquivo e o tipo de compactação e a codificação, se aplicável. Os tipos de compactação disponíveis para seleção dependem do tipo de arquivo.

    Para CSV, as outras configurações que você pode configurar são:

    • Se todos os arquivos tiverem a primeira linha como linha de cabeçalho, selecione Os dados têm cabeçalho.
    • Se os valores nas linhas de dados tiverem várias linhas, selecione Diversas Linhas.
    • Especifique o Caractere de escape que escapa outros caracteres encontrados nos valores de dados. Por exemplo: \
    • Selecione o caractere Delimitador que separa os campos de dados. Por exemplo: COLON (:), COMMA (,), PIPE (|), SEMICOLON (;) ou TAB (\t)
    • Especifique o Caractere de aspas que trata outros caracteres como literais. Por exemplo: "
    • Se um delimitador de coluna estiver incluído no final de uma linha de dados em todos os arquivos, selecione Delimitor final.

    O seguinte só está disponível quando você selecionou Usar entidade de dados existente em Definições de carregamento de entidades de dados de destino: Para arquivos JSON, selecione Usar esquema personalizado se quiser colar ou fazer upload de um esquema de amostra personalizado que é usado para inferir a forma da entidade.

    • Se você selecionar Fazer Upload, elimine um arquivo de esquema personalizado na caixa fornecida ou clique em Selecionar um arquivo para selecionar o arquivo de esquema para upload.

    • Se você selecionar Colar no esquema, copie o conteúdo do arquivo de texto do esquema e cole-o na caixa fornecida.

    Autonomous Data Warehouse, Autonomous Transaction Processing

    • Se o ativo de dados selecionado estiver configurado com um local de preparação padrão, o Data Integration usará automaticamente esse bucket do Object Storage para preparação. Use o local de preparação padrão configurado para o ativo de dados ou especifique um local de preparação diferente.

      Para usar outro local de preparação, em Local de preparação, desmarque a caixa de seleção Usar definições de local de preparação padrão. Em seguida, use os menus de recurso para selecionar um ativo de dados do serviço Object Storage, uma conexão, um compartimento e, em seguida, o bucket (esquema) a ser usado para preparação.

    • Se o ativo de dados selecionado não tiver um local de preparação padrão configurado, use os menus de recurso para selecionar um ativo de dados, uma conexão, um compartimento e, em seguida, o bucket (esquema) a ser usado para preparação.
Depois de selecionar o ativo de dados, a conexão, o esquema (ou o bucket) e as opções de destino aplicáveis, configure as definições de carga de destino para uma entidade de dados nova ou existente.
Usando Novas Entidades de Dados de Destino

O Data Integration pode criar novas entidades de dados de destino ao carregar dados das entidades de origem.

Para o tipo de carga de entidade de dados única, você só pode usar um parâmetro para a entidade de dados quando escolhe a opção de informar um nome de entidade de dados.

  1. Vá para a etapa Destino, guia Entidades de dados.
  2. Em Definições de carga de entidades de dados de destino, selecione Criar nova entidade de dados.

    Para um novo destino, a estratégia de integração é sempre Inserir.

  3. Somente para o destino do Object Storage: Marque a caixa de seleção Criar saída como um único arquivo se quiser usar um único arquivo de saída. Caso contrário, diversos arquivos serão criados.

    O arquivo de saída único é substituído toda vez que a tarefa é executada. A criação de um único arquivo de saída pode afetar o desempenho do Data Integration. Não use a opção de arquivo de saída único para grandes conjuntos de dados.

    Para vários tipos de carregamento de entidades de dados, cada nova entidade no destino tem um único arquivo correspondente.

  4. Especifique a opção Nome da entidade de dados de destino que você deseja para o novo destino. Você pode escolher entre:

    • Usar os mesmos nomes de entidade da origem: Selecione essa opção para criar entidades de destino com os mesmos nomes das entidades de origem.

    • Adicionar prefixo/sufixo: Selecione essa opção para adicionar uma string no início (prefixo) ou no final (sufixo) dos nomes de entidade de origem para criar os nomes das entidades de destino.

    • (Apenas para um único tipo de carga de entidade) Especificar nome da entidade: Digite o novo nome da entidade de destino no campo.

      • Para o Object Storage: Digite o novo nome da entidade de dados, seguido por uma barra (/). Por exemplo, digite newfile/ ou newdirectory/newfile/. No entanto, se você selecionar a caixa de seleção Criar saída como arquivo único porque deseja criar uma única saída de arquivo, digite o novo nome da entidade sem a barra (/) no final.

      • Para um destino de banco de dados: Se o nome da entidade que você informar já existir, o resultado da operação dependerá da forma do destino da tarefa do carregador de dados e da forma da entidade existente.

  5. (Opcional) (Somente para o tipo de carga de entidade única) Você só poderá designar um parâmetro à entidade de dados se tiver optado por informar um nome de entidade de dados na etapa anterior. Execute um dos seguintes procedimentos:
    • Selecione Parameterizar ao lado do recurso para designar um parâmetro a esse recurso. Ao parametrizar, o Data Integration adiciona um parâmetro do tipo apropriado e define o valor do parâmetro padrão para o valor que está configurado no momento para esse recurso.
    • Se disponível, selecione Reutilizar parâmetro de entidade de dados de origem para usar o parâmetro de entidade de origem como o parâmetro dessa entidade de dados de destino. Para obter mais informações, consulte Reutilizando Parâmetros para Recursos de Origem ou de Destino.
  6. Se aplicável, selecione a guia Definições e digite um valor para Limite de rejeição.

    Para Autonomous Data Warehouse ou Autonomous Transaction Processing:

    Você pode especificar o número máximo de linhas erradas que podem falhar ao serem carregadas para o destino antes de a tarefa falhar. Por exemplo, se a origem de dados tiver 1.000 linhas e você definir o limite de rejeição como 200, a tarefa falhará imediatamente após a 200a linha errada ser rejeitada.

    Se você não especificar um valor, o padrão será zero, o que significa que a tarefa falhará quando a primeira linha errada for rejeitada.

    Se ocorrer uma falha de tarefa, verifique os logs dos nomes das tabelas em que as linhas foram rejeitadas. Em seguida, consulte as tabelas e as linhas afetadas no banco de dados autônomo.

Usando Entidades de Dados de Destino Existentes

Ao usar entidades de dados de destino existentes, você seleciona a estratégia de integração que determina como carregar dados para o destino existente.

Para um único tipo de carga de entidade de dados, você pode usar um parâmetro para a entidade de dados depois de selecionar uma entidade de dados.

  1. Vá para a etapa Destino, guia Entidades de dados.
  2. Em Definições de carga de entidades de dados de destino, selecione Usar entidade de dados existente.
  3. Para especificar como carregar dados para o destino, selecione uma das opções de estratégia de integração disponíveis.

    • Inserir: Insere novos registros ou anexa os registros quando os dados existem no destino.

    • Substituir: Executa um truncamento no destino antes de inserir novos registros.

      A estratégia de integração deverá ser Substituir se você quiser criar a saída como arquivo único para o destino do Object Storage.

    • Mesclar: Insere novos registros e mescla os existentes. A estratégia de mesclagem está disponível apenas para destinos de banco de dados.

      Para o tipo de carga de entidade de dados Única (consulte a etapa 5), você tem a opção de selecionar uma chave exclusiva diferente da chave primária para mesclar dados.

      Para o tipo de carga Várias entidades de dados, a chave primária é usada por padrão. Nenhuma ação ou seleção adicional é necessária.

  4. Somente para estratégia de Substituição e destino do Object Storage: Marque a caixa de seleção Criar saída como arquivo único se quiser usar um único arquivo de saída. Caso contrário, diversos arquivos serão criados.

    O arquivo de saída único é substituído toda vez que a tarefa é executada. A criação de um único arquivo de saída pode afetar o desempenho do Data Integration. Não use a opção de arquivo de saída único para grandes conjuntos de dados.

    Para vários tipos de carregamento de entidades de dados, cada entidade selecionada no destino tem um único arquivo correspondente.

  5. Para o tipo de carga Entidade de dados única:
    1. Na tabela Entidades de dados disponíveis, selecione uma entidade de dados. É possível

      • Marque a caixa de seleção ao lado do nome de uma entidade e selecione Definir como destino.

      • Filtrar a lista digitando um nome ou um padrão no campo e pressionando Enter.

        Você pode digitar um nome parcial ou um padrão usando caracteres especiais como *. Por exemplo, você pode digitar ADDRESS_* para encontrar ADDRESS_EU1, ADDRESS_EU2 e ADDRESS_EU3.

        Na lista filtrada, marque a caixa de seleção ao lado do nome de uma entidade e, em seguida, selecione Definir como destino.

      • Para um destino do Object Storage com a estratégia de integração Substituir, selecione uma entidade de dados existente que não tenha a barra (/) no final do nome da entidade.
      O nome da entidade dos dados que você seleciona é exibido ao lado da Entidade dos dados selecionados do label. Para selecionar outra entidade de dados a ser usada como destino, selecione Remover e, em seguida, selecione a entidade na tabela Entidades de dados disponíveis.
    2. (Opcional) Você pode designar um parâmetro à entidade de dados depois de selecionar uma entidade de dados na etapa anterior. Execute um dos seguintes procedimentos:
      • Selecione Parameterizar ao lado do recurso para designar um parâmetro a esse recurso. Ao parametrizar, o Data Integration adiciona um parâmetro do tipo apropriado e define o valor do parâmetro padrão para o valor que está configurado no momento para esse recurso.
      • Se disponível, selecione Reutilizar parâmetro de entidade de dados de origem para usar o parâmetro de entidade de origem como o parâmetro dessa entidade de dados de destino. Para obter mais informações, consulte Reutilizando Parâmetros para Recursos de Origem ou de Destino.
    3. (Opcional) Para um destino de banco de dados com a estratégia de integração Mesclar:

      A chave Mesclar identifica o atributo ou os atributos para determinar quais linhas existentes ou novas linhas atualizar ou inserir. Você pode selecionar uma chave primária/exclusiva ou uma chave não primária como a chave Mesclar.

      Clique em Selecionar ou Editar. No painel Mesclar chave, execute uma das seguintes ações:

      • Selecione Atributos de chave Principal/Exclusivo e selecione uma chave.
      • Selecione Outros atributos para usar outros atributos (não principais). Informe um nome para a chave de mesclagem e selecione os atributos na lista.
  6. Para o tipo de carga Diversas entidades de dados: Por padrão, as entidades de dados de origem são automaticamente mapeadas para entidades de dados de destino disponíveis, por nome.
    1. Na tabela entidades de dados de origem, coluna Mapeamento, você pode colocar o cursor sobre um mapeamento que tenha uma marca de seleção verde para ver o nome da entidade de destino mapeada.
    2. Para criar um mapeamento manual, arraste a entidade de dados de origem para a entidade de dados de destino. Uma regra de mapeamento é adicionada quando você executa um mapeamento manual.
    3. Para remover um mapeamento automático ou manual, na tabela Entidades de dados de destino, coluna Mapeamento, selecione Limpar ao lado de um mapeamento. Em seguida, selecione Limpar mapeamento para confirmar que você deseja remover o mapeamento. Uma regra de mapeamento é adicionada quando você limpa um mapeamento.
    4. Na tabela entidades de dados de origem ou entidades de dados de destino, você pode:

      • Filtrar a lista digitando um nome ou um padrão no campo e pressionando Enter.

        Você pode digitar um nome parcial ou um padrão usando caracteres especiais como *. Por exemplo, você pode digitar ADDRESS_* para encontrar ADDRESS_EU1, ADDRESS_EU2 e ADDRESS_EU3.

      • Exibir todas as entidades, entidades mapeadas ou entidades não mapeadas, selecionando a opção apropriada no menu acima da tabela.

    5. No menu Ações, você pode selecionar:

      • Mapear automaticamente por nome: Use essa ação para permitir que o Data Integration crie automaticamente mapeamentos entre entidades de origem e entidades de destino por nome.

      • Mapa por padrão: Use essa ação para definir um padrão de origem e um padrão de destino para mapear entidades de origem para entidades de destino. A correspondência de padrão faz distinção entre maiúsculas e minúsculas.

        Consulte Mapear por Padrão

    Para gerenciar regras de mapeamento, consulte Exibindo e Removendo Regras de Mapeamento.
Exibindo e Removendo Regras de Mapeamento (Diversas Entidades de Dados de Destino)

O Data Integration adiciona regras de mapeamento quando você mapeia manualmente entidades de dados de origem para entidades de dados de destino existentes para uma tarefa do carregador de dados.

As regras também são adicionadas quando você remove mapeamentos.

  1. Vá para a etapa Destino, guia Entidades de dados.
  2. Para exibir as regras criadas para uma tarefa de carregador de dados, selecione Exibir mapeamentos.
  3. No painel Regras de mapeamento de entidade, revise os mapeamentos que você criou.
  4. Para remover uma regra de mapeamento, você pode usar uma de duas maneiras:

    • Marque a caixa de seleção de uma regra e selecione Remover.

    • Selecione o menu (Ações menu) Ações de uma regra e, em seguida, selecione Remover.