Documentação do Oracle Cloud Infrastructure

Carregando Dados de Arquivos Locais

Para carregar dados de arquivos locais para o Oracle Autonomous Database, na página Carga 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 Carga 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: 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 folhas da planilha aparecem como itens individuais. O item mostra o nome do arquivo de origem ou da planilha e seu tamanho e o nome da tabela que é o destino da carga de dados. A ferramenta Carga de Dados suporta o carregamento de tabelas somente 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 carga de dados.

Para remover um arquivo de origem do Carrinho de Carga 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 do Carrinho de Carga de Dados.

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

Especificar Opções de Processamento

Para especificar definições para o job de carga de dados ou visualizar os dados na origem ou no destino, selecione o ícone Definições (lápis) do item no Carrinho de Carga de Dados.

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

O Nome especifica o nome da tabela de destino. O valor no campo varia dependendo da 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, digite-o no campo Nome. Para as outras opções da tabela de destino, no campo Opções, o valor padrão é <None>. Expanda a lista drop-down e selecione uma tabela existente como destino.

No campo Opções, selecione Create Table, Insert into Table, Replace Data, Drop Table and Create New Table ou Merge into Table. Aponte para o ícone de 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 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 informe o comando a seguir na área de planilha SQL exibida na guia SQL em ferramentas de Desenvolvimento presentes no Launchpad. 

Grant PDB_DBA to Username;

Essa lista drop-down 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 de coluna 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 delimitam o texto, selecione o caractere de aspas duplas ou aspas simples ou None na lista drop-down Delimitação 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 do padrão vírgula para um ponto-e-vírgula.

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

Modelo de Definições

O recurso de salvar definições salva a configuração definida nas definições do Carrinho na forma de um arquivo JSON. Ao abrir o modelo Configurações, você tem as seguintes opções:
  1. Carregar Modelo de Definições: Carrega um modelo de definições do seu sistema local.
  2. Salvar Modelo de Definições: Salva o modelo de definições existente atual.
Veja a seguir a descrição das definições template.png
Descrição das configurações da ilustração-template.png
Você pode usar o Modelo de Definições de Carregamento 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 JSON do Modelo de Definições para carregar um arquivo JSON do seu sistema.
  3. Clicar no modelo de Definições JSON abrirá seu 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 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 arquivo de modelo é exibido. Clique no nome do Arquivo de Modelo e nomeie o novo modelo.
  3. Clique em OK para terminar de salvar o novo nome do modelo existente.
  4. Você pode testar a configuração do novo modelo.

Configurações de Edição em Massa

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 atualmente no painel de resultados. Você pode procurar os valores da coluna que deseja editar no campo de pesquisa e clicar no ícone de ampliação. A tabela de mapeamento exibirá os resultados da pesquisa. Selecione a configuração Edição em lote para atualizar a coluna. A configuração Edição em lote 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.
  • Inclua 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, além do ícone de configuração Edição em massa, filtra a lista de colunas que você deseja atualizar em massa. Assim que você começa a digitar no campo de pesquisa, a ferramenta retorna os valores de campo que contêm as letras que você digita. Você pode remover o filtro excluindo todo o conteúdo da caixa de pesquisa e clicando no ícone de lupa que aparece ao lado da caixa.

A configuração 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 da primeira para a quinta linhas de VARCHAR para NUMBER na tabela de mapeamento.A seguir, descrição de bulk-edit1.png
Descrição da ilustração bulk-edit1.png

Especifique 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-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 do cabeçalho do arquivo, na seção Mapeamento, aceite os valores padrão das colunas de destino e os tipos de dados ou especifique valores diferentes. Para especificar valores diferentes, informe um nome para a coluna na coluna de destino. Na coluna Tipo de Dados, selecione um tipo de dados na lista drop-down. Se você não estiver obtendo os nomes das colunas de origem do 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 quando 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 após a correção do 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 estiver preenchido. Veja a seguir a descrição da dica de ferramenta error.png
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. Especifique pelo menos uma coluna como coluna de chave. Para especificar uma coluna como coluna de chave, marque a caixa de seleção chave de mesclagem da 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, essa opção ativa automaticamente a seleção de colunas de chave primária como chaves de mesclagem.

Para as opções Inserir na Tabela ou Submeter 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.

Nenhuma modificação feita na visualização de origem afeta a carga de dados do arquivo.

Visualizar Dados de Destino

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

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

Executar o Job de Carga de Dados

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

Depois que o job de carga de dados for iniciado, você poderá exibir o andamento do job no painel de controle de Carga de Dados. Consulte A Página Carga de Dados para obter mais detalhes.

Quando o job de carga de dados é concluído, a página do painel Carga de Dados exibe os resultados do job. Na parte superior do cabeçalho da carga da tabela, você pode exibir o nome da tabela juntamente com o total de colunas presentes na tabela.

Clique em Relatório para exibir o número total de linhas processadas com sucesso e a contagem de linhas rejeitadas. Você também pode visualizar a hora 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 na Carga da Tabela.

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

A lista de tabelas na página Carga de Dados contém novas tabelas criadas. As tabelas de destino para as opções Insert in Table, Replace Data, Drop Table and Create New Table e Merge into Table contêm os dados carregados.

Corrigindo um job de carga de dados

Após o job de carga de dados, você poderá ver erros que deseja corrigir ou, na inspeção, perceber que deseja nomear uma coluna de maneira 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 na carga da Tabela e selecione Editar para fazer alterações no job de carga de dados (ou seja, alterar um nome de coluna).

Clique em Aplicar para aplicar as alterações. Clique em Fechar para retornar à página do Database Actions.

Tópico principal: Carregando Dados