Opções de Formato do Pacote DBMS_CLOUD
O argumento de formato em DBMS_CLOUD
especifica o formato dos arquivos de origem.
As duas maneiras de especificar o argumento de formatação são:
format => '{"format_option" : “format_value” }'
E:
format => json_object('format_option' value 'format_value'))
Exemplos:
format => json_object('type' VALUE 'CSV')
Para especificar várias opções de formato, separe os valores com uma vírgula (",
").
Por exemplo:
format => json_object('ignoremissingcolumns' value 'true', 'removequotes' value 'true', 'dateformat' value 'YYYY-MM-DD-HH24-MI-SS', 'blankasnull' value 'true', 'logretention' value 7)
Para obter as opções de formato Avro, ORC ou Parquet, consulte DBMS_CLOUD Opções de Formato de Pacote para Avro, ORC ou Parquet.
Conforme observado na coluna Opção de Formato, um conjunto limitado de opções de formato é válido com DBMS_CLOUD.COPY_COLLECTION
ou com DBMS_CLOUD.COPY_DATA
quando o format
type
é JSON.
Opção de Formato | Descrição | Sintaxe |
---|---|---|
|
Especifica o tipo de tabela do Apache Iceberg, como AWS ou OCI Object Storage, e quais informações são usadas para criar a tabela externa, por exemplo, informações de um catálogo de dados ou de um URI de metadados direto. |
Consulte Procedimento CREATE_EXTERNAL_TABLE para Apache Iceberg, para obter detalhes sobre a sintaxe |
|
Quando definido como |
Valor padrão: |
Válido com |
Especifica o conjunto de caracteres dos arquivos de origem |
Valor padrão: Conjunto de caracteres do banco de dados |
Use somente com |
Array de expressões de caminho JSON que correspondem aos campos que precisam ser extraídos dos registros JSON. Cada uma das expressões de caminho JSON no array deve seguir as regras descritas em Expressões de Caminho SQL/JSON. Só use com o formato JSON e |
Array JSON de expressões de caminho json expressas em formato de string. Por exemplo: valor de 'columnpath' |
Opção válida com dados JSON |
Especifica o tipo de compactação do arquivo de origem. Formato de arquivamento ZIP não é suportado. A especificação do valor |
Valor padrão: Valor nulo que significa nenhuma compactação. |
|
Se uma linha for rejeitada por causa de erros de conversão do tipo de dados, as colunas relacionadas serão armazenadas como nulas ou a linha será rejeitada. |
Valor padrão: |
|
Especifica o formato de data no arquivo de origem. A opção de formato J MM-DD-YYYYBC MM-DD-YYYY YYYYMMDD HHMISS YYMMDD HHMISS YYYY.DDD YYYY-MM-DD |
Valor padrão: Formato de data do banco de dados |
|
Especifica o delimitador de campo. Para usar um caractere especial como delimitador, especifique o valor HEX do código ASCII do caractere. Por exemplo, o seguinte especifica o caractere TAB como delimitador:
|
Valor padrão |
|
Especifica que os campos nos arquivos de dados externos estão em uma ordem diferente das colunas na tabela. Detecte a ordem dos campos usando a primeira linha de cada arquivo de dados externo e mapeie-o para as colunas da tabela. Os nomes dos campos em arquivos de dados externos são comparados de maneira que não faça distinção entre maiúsculas e minúsculas e os nomes das colunas da tabela. Essa opção de formato é aplicável para os seguintes procedimentos:
Restrições para
Consulte NOMES DE CAMPO e a descrição de |
Valor padrão: |
|
A opção de formato
Por exemplo: format => JSON_OBJECT('enablelogs' value FALSE) |
Valor padrão: |
|
A opção de formato Use
Os valores dos Modificadores de Encadeamento de Cifragem de Bloco e dos Modificadores de Preenchimento de Cifragem de Bloco assumem como padrão A opção de formato
encryption é usada com os seguintes procedimentos DBMS_CLOUD :
Por exemplo: format => JSON_OBJECT('encryption' value json_object ('type' value DBMS_CRYPTO.ENCRYPT_AES256 + DBMS_CRYPTO.CHAIN_CBC + DBMS_CRYPTO.PAD_PKCS5, 'credential_name' value 'ENCRYPTION_CRED')) |
encryption:value Em que valor é uma string JSON que fornece parâmetros adicionais para criptografia:
Especifica o tipo de criptografia.
Especifica a credencial usada para armazenar a chave de criptografia. user_defined_function: value Especifica uma função totalmente qualificada definida pelo usuário para decriptografar ou criptografar o BLOB especificado (objeto grande binário). |
|
Os dados podem ser delimitados entre dois delimitadores, especificados com Por exemplo: format => JSON_OBJECT(‘quote’ value ‘(’, ‘endquote’ value ‘)’) |
Valor padrão: Nulo, significando que não há |
|
O caractere "\" é usado como o caractere de escape quando especificado. |
Valor padrão: |
Opção válida com dados JSON |
As linhas em branco são ignoradas quando definidas como verdadeiras. |
Valor padrão: |
|
Se houver mais colunas no |
Valor padrão |
|
Ative o particionamento implícito e especifique os nomes das colunas da partição usando a opção de formato O particionamento implícito está ativado das seguintes maneiras:
Consulte |
Valor padrão: Se |
|
Ative o particionamento implícito e especifique os tipos de dados das colunas de partição usando a opção de formato Consulte |
Valor padrão: Se |
Usar somente com |
Caminho JSON para identificar o documento a ser carregado. Essa opção só é válida para dados de coleta JSON com |
Valor padrão: Nulo |
keyassignment Usar somente com |
Especifica se uma nova coleção é criada como uma coleção compatível com mongo ou como uma coleção SODA. Quando o valor é definido como Por padrão, esse parâmetro não está definido, o que significa que uma nova coleção é criada como uma coleção SODA. |
Padrão: |
Usar somente com |
Especifica um atributo nos dados a serem carregados como o valor Se Defina o valor como um caminho, por exemplo, Este parâmetro é opcional e só é válido para carregamento em coleções compatíveis com mongo. Se não for especificado, o sistema Oracle gerará um ID de sistema exclusivo de 12 bytes e o preencherá como o atributo |
Padrão: Quando |
|
Especifica o nome de um idioma (por exemplo, FRENCH), cujas informações de configuração regional podem ser derivadas. |
Valor padrão: Nulo Consulte Locale Data no Oracle Database Globalization Support Guide para obter uma listagem de idiomas suportados pelo sistema Oracle. |
|
Especifica um valor de string que determina o nome do objeto de diretório onde os arquivos Por padrão, o Por exemplo:
A opção de formato
A opção de formato |
Valor padrão: |
|
Especifica um valor de string que determina o prefixo para os arquivos O formato do nome da tabela de log é: logprefix Por padrão, o logprefix está em letras maiúsculas, mas a letra é reservada quando o valor especificado é colocado entre aspas duplas. Por exemplo: format => JSON_OBJECT ('logprefix' value 'TEST') Os arquivos de log usam o prefixo |
Valor padrão: |
|
Especifica uma duração de número inteiro positivo, em dias, para a qual os arquivos Valores válidos: Por exemplo: format => JSON_OBJECT ('logretention' value 7) |
Valor padrão: |
Esta opção só é válida com dados JSON |
Tamanho máximo de documentos JSON. |
Valor padrão: 1 Megabyte Valor máximo permitido: 2 Gigabytes |
|
Especifica os caracteres a serem usados como separador de grupo e caractere decimal. decimal_character: O decimal separa a parte inteira de um número da parte decimal. group_separator: O separador de grupo separa grupos de números inteiros (ou seja, milhares, milhões, bilhões etc.). |
Valor padrão: Consulte NLS_NUMERIC_CHARACTERS no Oracle Database Globalization Support Guide para obter mais informações. |
|
Especifica o modelo de formato de número. Os modelos de formato numérico fazem com que o número seja arredondado para o número especificado de dígitos significativos. Um modelo de formato de número é composto de um ou mais elementos de formato de número. É usado em combinação com |
Valor padrão: é derivado da definição do parâmetro Consulte Modelos de Formato de Número em Referência de Linguagem SQL para obter mais informações. |
|
A opção de formato
Se os arquivos de dados forem desestruturados e a subcláusula Para nomes de objeto que não se baseiam no formato de colmeia, a ordem das colunas especificadas |
|
|
Especifica o caractere de aspas para os campos. Os caracteres |
Valor padrão: Nulo, que significa nenhuma cota |
Opção válida com dados JSON |
Especifica o delimitador de registro. Por padrão, Especifique este argumento explicitamente se quiser substituir o comportamento padrão, por exemplo:
Para indicar que não há delimitador de registro, você pode especificar um
O |
Valor padrão: nova linha detectada |
|
A opção de formato
Quando o valor de Os caracteres "*" e "?" são considerados caracteres curinga quando o parâmetro Só há suporte para padrões de expressão regular no nome do arquivo ou no caminho da subpasta em seus URIs, e a correspondência de padrões é idêntica à executada pela função Para tabelas externas, essa opção só é suportada com as tabelas criadas em um arquivo no Object Storage. Por exemplo:
Consulte REGEXP_LIKE Condição para obter mais informações sobre a condição |
Valor padrão: |
|
A operação resultará em erro após o número especificado de linhas ser rejeitado. |
Valor padrão: |
|
Remove todas as aspas que estão ao redor de qualquer campo no arquivo de origem. |
Valor padrão: |
|
Especifica quantas linhas devem ser ignoradas do início do arquivo. |
Valor padrão: 0 se não for especificado, 1 se for especificado sem um valor |
|
Especifica um nome de território para determinar melhor as características dos dados de entrada. |
Valor padrão: Nulo Consulte Locale Data no Oracle Database Globalization Support Guide para obter uma listagem de territórios suportados pelo sistema Oracle. |
|
Especifica o formato de timestamp no arquivo de origem. A opção de formato YYYY-MM-DD HH:MI:SS.FF YYYY-MM-DD HH:MI:SS.FF3 YYYY-MM-DD HH24:MI:SS.FF3 MM/DD/YYYY HH:MI:SS.FF3 |
Valor padrão: Formato de timestamp do banco de dados A string pode conter caracteres curinga, como "$". |
|
Especifica o timestamp com o formato de fuso horário local no arquivo de origem. A opção de formato DD Mon YYYY HH:MI:SS.FF TZR MM/DD/YYYY HH:MI:SS.FF TZR YYYY-MM-DD HH:MI:SS+/-TZR YYYY-MM-DD HH:MI:SS.FF3 DD.MM.YYYY HH:MI:SS TZR |
Valor padrão: Timestamp do banco de dados com formato de fuso horário local |
|
Especifica o timestamp com o formato de fuso horário no arquivo de origem. A opção de formato DD Mon YYYY HH:MI:SS.FF TZR MM/DD/YYYY HH:MI:SS.FF TZR YYYY-MM-DD HH:MI:SS+/-TZR YYYY-MM-DD HH:MI:SS.FF3 DD.MM.YYYY HH:MI:SS TZR |
Valor padrão: Timestamp do banco de dados com formato de fuso horário |
|
Especifica como os espaços à esquerda e à direita dos campos são cortados. Consulte a descrição de trim_spec. |
Valor padrão: |
|
Se os dados do arquivo forem muito longos para um campo, essa opção truncará o valor do campo em vez de rejeitar a linha. |
Valor padrão: |
|
Especifica o tipo de arquivo de origem. Consulte a descrição de Se o Se o Consulte DBMS_CLOUD Opções do Formato do Pacote para Avro, ORC ou Parquet para obter os valores Para dados JSON com Para dados JSON com
|
Observação
Nem todos os procedimentos do DBMS_CLOUD suportam todos esses tipos.
Valor padrão: Nulo Para dados JSON, há dois valores |
Usar somente com |
Quando definido como Quando definido como Essa opção só é válida para dados de coleta JSON com |
Valor padrão: |
Tópico principal: Pacote DBMS_CLOUD