Documentação do Oracle Cloud Infrastructure

Carregando Dados de Arquivos Locais

Para carregar dados de arquivos locais no Oracle Autonomous Database, na página Carregamento de Dados, selecione LOAD DATA e LOCAL FILE.

Arraste um ou mais arquivos do navegador do sistema de arquivos local e solte-os no Carrinho de Carregamento de Dados. Você também pode clicar em Selecionar Arquivos ou no ícone Selecionar Arquivos, selecionar um ou mais arquivos no navegador do sistema de arquivos e clicar em Abrir.

Você pode adicionar arquivos nestes formatos de arquivo: AVRO, CSV, JSON, GeoJSON, TSV, TXT delimitado, XLS, XLSX, XML, PNG, JPEG e PDF. Para obter informações sobre formatos de arquivo suportados, consulte Especificações de Formato para Arquivos JSON, AVRO e XML.

Um item para cada arquivo aparece no carrinho. Para uma planilha XLS ou XLSX, as planilhas da planilha aparecem como itens individuais. O item mostra o nome do arquivo de origem ou da planilha e seu tamanho, além do nome da tabela que é o destino do carregamento de dados. A ferramenta Carregamento de Dados suporta o carregamento de tabelas apenas da primeira planilha de um arquivo XLSX de várias planilhas quando o arquivo está em um armazenamento de objetos.

Você pode adicionar mais arquivos ao carrinho clicando no ícone Selecionar Arquivos. Você pode adicionar qualquer número de arquivos ao carrinho e carregar dados de todos eles em um único job de carregamento de dados.

Para remover um arquivo de origem do Carrinho de Carregamento de Dados, clique no ícone Remover (lixeira) do item de origem. Para remover todos os arquivos de origem do carrinho, clique no ícone Remover Tudo (lixeira) na barra de menus Carrinho de Carregamento de Dados.

Para retornar à página Carregamento de Dados, clique em Carregamento de Dados acima da barra de menus Carrinho de Carregamento de Dados.

Especificar Opções de Processamento

Para especificar configurações para o job de carregamento de dados ou visualizar os dados na origem ou no destino, selecione o ícone Configurações (lápis) do item no Carrinho de Carregamento de Dados.

No painel de configurações, na guia Configurações, você pode exibir o nome e o tamanho do arquivo no título da caixa de diálogo Carregar Dados.

O campo Nome especifica o nome da tabela de destino. O valor no campo varia de acordo com a seleção no campo Opções. Se a opção for Criar Tabela, o valor de destino padrão será o nome do arquivo de origem ou da planilha.

Para especificar outro nome para a tabela de destino, informe-o no campo Nome. Para as outras opções de tabela de destino no campo Opções, o valor padrão é <Nenhum>. Expanda a lista drop-down e selecione uma tabela existente como destino.

No campo Opções, selecione Criar Tabela, Inserir na Tabela, Substituir Dados, Eliminar Tabela e Criar Nova Tabela ou Mesclar na Tabela. Aponte para o ícone do ponto de interrogação para ver uma breve descrição da opção selecionada.

Selecione outro esquema na lista drop-down Esquema para criar sua tabela de destino em outro esquema.
Observação

A lista drop-down Esquema só estará disponível se você tiver a concessão de atribuição PDB_DBA a você.

Para conceder a si mesmo uma atribuição PDB_DBA, faça log-in na instância do Database Actions e digite o seguinte comando na área de planilha SQL exibida na guia SQL em ferramentas de Desenvolvimento presentes no Launchpad. 

Grant PDB_DBA to Username;

Essa lista suspensa está disponível para as opções Criar Tabela e Eliminar Tabela e Criar Nova Tabela.

A opção Nome da coluna de origem especifica se os nomes das colunas de origem e destino devem ser obtidos do arquivo ou se os nomes das colunas devem ser especificados manualmente. A obtenção dos nomes das colunas do cabeçalho do arquivo de origem é o padrão. Se você selecionar a opção Cabeçalho da coluna, a primeira linha do arquivo será processada como nomes de coluna. Se você desmarcar a opção, a primeira linha será processada como dados. Para especificar nomes de coluna manualmente, informe um nome para cada coluna de destino na seção Mapeamento. Você também pode selecionar um tipo de dados para a coluna.

O campo Iniciar processamento de dados na linha especifica quantas linhas devem ser ignoradas ao carregar os dados de origem no destino. Se você tiver selecionado a opção Cabeçalho da coluna e informar um número maior que 0 no campo Iniciar processamento de dados na linha, esse número de linhas após a primeira linha não será carregado no destino. Se você tiver desmarcado a opção Cabeçalho da coluna e informar um número maior que 0 no campo Iniciar processamento de dados na linha, esse número de linhas, incluindo a primeira linha, não será carregado no destino.

Para alterar a codificação do conjunto de caracteres do conteúdo do arquivo, selecione um valor na lista drop-down Codificação.

Para especificar os caracteres que envolvem texto, selecione o caractere de aspas duplas ou de aspas simples ou None na lista drop-down Anexo de texto.

Para alterar o caractere delimitador que separa colunas na origem, expanda a lista drop-down Delimitador de campo e selecione um caractere. Por exemplo, se o arquivo tiver colunas delimitadas por ponto e vírgula, altere o delimitador do delimitador de vírgula padrão para um ponto e vírgula.

Para converter qualquer valor inválido em uma coluna de origem numérica em um valor nulo na coluna de destino, selecione a opção Converter dados inválidos em nulos da coluna Numérica.

Modelo de Definições

O recurso salvar configurações salva o conjunto de configurações nas configurações do Carrinho na forma de um arquivo JSON. Ao abrir o modelo Configurações, você tem as seguintes opções:
  1. Modelo de Definições de Carga: Carrega um modelo de definições do sistema local.
  2. Salvar Modelo de Definições: Salva o modelo de definições existente atual.
Descrição da settings-template.png a seguir
Descrição da ilustração settings-template.png
Você pode usar o Modelo de Definições de Carga se quiser usar um modelo personalizado existente presente em seu local.
  1. Na guia Definições da página Carregar Dados, selecione Carregar Modelo de Definições.
  2. Você verá um assistente Carregar Modelo de Definições, clique no Modelo de Definições JSON para carregar um arquivo JSON do seu sistema.
  3. Clicar no modelo de Definições JSON abrirá o sistema local. Clique em OK para carregar o arquivo JSON.
  4. Depois de carregar o arquivo JSON, você poderá exibir as atualizações aplicadas automaticamente à guia de definições que corresponde ao modelo de definições JSON que você carrega do seu local.
Você pode usar o Modelo de Salvar Definições para salvar o modelo de Definições atual existente.
  1. Na guia Definições da página Carregar Dados, selecione Salvar Modelo de Definições.
  2. O editor de arquivos Modelo é exibido. Clique no nome do Arquivo de Modelo e nomeie o novo modelo.
  3. Clique em OK para concluir o salvamento do novo nome do modelo existente.
  4. Você pode testar a configuração do novo modelo.

Configurações de edição em lote

Você pode usar as configurações de edição em massa para atualizar todas as colunas de uma só vez na tabela de mapeamento. Use-o para aplicar alterações à seleção exibida no momento no painel de resultados. Você pode procurar os valores da coluna que deseja editar no campo de pesquisa e clicar no ícone de lupa. A tabela de mapeamento exibirá os resultados da pesquisa. Selecione a configuração Edição em massa para atualizar a coluna. A configuração Edição em massa permite:
  • Atualize os valores de todos os campos de um grupo.
  • Localizar e substituir, Adicionar Prefixo e Adicionar sufixo ao nome da coluna de destino.
  • Incluir a(s) coluna(s) para carregar dados na tabela de destino.
  • Exclua a(s) coluna(s) para carregar dados na tabela de destino.

Pesquisando a Coluna

A configuração Edição em lote atualiza as colunas retornadas pelo campo de pesquisa. A caixa de pesquisa abaixo das Colunas Disponíveis no assistente de Mapeamento de Edição em Massa filtra a lista de colunas que você deseja atualizar em massa. Você também pode clicar na coluna que deseja selecionar na lista de Colunas Disponíveis. Escolha qualquer uma das opções disponíveis:
  • >: Esta opção permite mover a coluna para Colunas Selecionadas.
  • <: Para remover a tabela selecionada das Colunas Selecionadas, selecione esta opção.
  • >>: Esta opção permite mover todas as tabelas para a tela Colunas Selecionadas.
  • <<: Para remover todas as tabelas selecionadas das Colunas Selecionadas, selecione esta opção.
O Mapeamento de edição em lote permite atualizar os valores das seguintes colunas para todas as pesquisas retornadas pelo campo de pesquisa:
  • Tipo de dados
  • Nome da Coluna de Destino
  • Incluir Colunas para carregamento
  • Excluir colunas para carregamento

Considere alterar o Tipo de Dados das cinco primeiras linhas de VARCHAR2 para CHAR na tabela de mapeamento.

Descrição da ilustração bulk-edit1.png segue
Descrição da ilustração bulk-edit1.png

Especificar Mapeamentos

Você pode filtrar os resultados na tabela de mapeamento com o campo Filtro Rápido que permite filtrar Colunas ou Expressões.

Selecione Adicionar Expressão para executar Análise de Sentimentos ou Extração de Frase de Chave com os dados de origem. Consulte Usar Recursos do Serviço OCI Language no Data Studio para obter mais detalhes.

Se você selecionar a opção Criar Tabela ou Eliminar Tabela e Criar Nova Tabela e estiver obtendo os nomes das colunas de origem no cabeçalho do arquivo, na seção Mapeamento, aceite os valores padrão para as colunas e os tipos de dados de destino ou especifique valores diferentes. Para especificar valores diferentes, na coluna de destino, informe um nome para a coluna. Na coluna Tipo de Dados, selecione um tipo de dados na lista drop-down. Se você não estiver obtendo os nomes da coluna de origem no cabeçalho do arquivo, para cada coluna de origem, especifique um nome para a coluna de destino e selecione um tipo de dados na lista drop-down Tipo de Dados. Para o tipo de dados Data, selecione um formato de data na lista drop-down Formato.
Observação

Você receberá uma mensagem de erro de dica de ferramenta com o motivo exato da mensagem de erro ao concluir a edição de uma célula. A célula da grade de mapeamento será destacada com vermelho para indicar um valor inválido que deve ser corrigido. O destaque é removido depois que você corrige o valor inválido. Por exemplo, você pode exibir a seguinte mensagem de erro de dica de ferramenta quando o nome da coluna de destino não for preenchido. Descrição da dica de ferramenta-error.png a seguir
Descrição da ilustração tooltip-error.png

Para a opção Mesclar na Tabela, para cada coluna de origem, selecione uma coluna de destino na lista drop-down. Você deve especificar pelo menos uma coluna como coluna-chave. Para especificar uma coluna como uma coluna de chave, marque a caixa de seleção Mesclar Chave para a coluna. Chaves de mesclagem são uma ou mais colunas que identificam de forma exclusiva cada linha da tabela. As chaves de mesclagem não devem conter valores nulos. Para carregar tabelas com chaves primárias, esta opção permite automaticamente a seleção de colunas de chave primária como chaves de mesclagem.

Para as opções Inserir na Tabela ou Substituir Dados, para cada coluna de origem, selecione uma coluna de destino na lista drop-down de colunas existentes.

Visualizar Dados de Origem

Para exibir uma seleção de dados no arquivo de origem, selecione a guia Visualizar. A guia Visualizar exibe um menu Arquivo que exibe os dados em formato tabular com seus valores. Você pode copiar a tabela. A guia Visualização de Carga exibe os dados de origem.

Qualquer modificação feita na visualização de origem não afeta o carregamento de dados do arquivo.

Visualizar Dados de Destino

Para todas as opções, exceto Criar Tabela, para exibir os dados existentes na tabela de destino, selecione a guia Visualização de Carga. A visualização de carregamento exibe os dados na tabela de destino antes de executar o job de carregamento de dados.

Para fechar o painel de configurações, clique em Fechar.

Executar o Job de Carregamento de Dados

Quando você tiver adicionado todas as origens do job e especificado as definições de cada origem, para executar o job, clique no ícone Iniciar na barra de menus Carrinho de Carregamento de Dados. Na caixa de diálogo Executar Job de Carregamento de Dados, clique em Iniciar. Para interromper o job de carregamento de dados, clique no ícone Interromper.

Assim que o job de carregamento de dados for iniciado, você poderá exibir o andamento do job no painel Carregamento de Dados. Consulte A Página Carregamento de Dados para obter mais detalhes.

Quando o job de carregamento de dados é concluído, o painel Carregamento de Dados exibe os resultados do job. Na parte superior do cabeçalho do carregamento da tabela, você pode exibir o nome da tabela junto com o total de colunas presentes na tabela.

Clique em Relatório para exibir o número total de linhas processadas com êxito e a contagem de linhas rejeitadas. Você também pode visualizar o horário de início. O painel SQL do Relatório exibe o código SQL equivalente do job.

Para exibir informações sobre um item no job, clique no ícone Ações no Carregamento de Tabela.

Para exibir um log da operação de carregamento, clique no ícone Registro em Log. Você pode salvar o log, limpá-lo ou atualizá-lo. Clique em OK para descartar o log.

A lista de tabelas na página Carregamento de Dados contém novas tabelas criadas. As tabelas de destino das opções Inserir na Tabela, Substituir Dados, Eliminar Tabela e Criar Nova Tabela e Mesclar na Tabela contêm os dados carregados.

Corrigindo um job do carregamento de dados

Após o job de carregamento de dados, você poderá ver erros que deseja corrigir ou, após a inspeção, perceber que deseja nomear uma coluna de forma diferente. Nesses casos, você verá um sinal de aviso no carregamento da Tabela. Clique no ícone Recarregar para recarregar a origem com correções sugeridas. Clique no ícone Ações no carregamento da Tabela e selecione Editar para fazer alterações no job de carregamento de dados (ou seja, alterar um nome de coluna).

Clique em Aplicar para aplicar quaisquer alterações. Clique em Fechar para retornar à página Ações do Banco de Dados.

Tópico principal: Carregando Dados