DBMS_CLOUD Opções de Formato do Pacote
O argumento de formato em DBMS_CLOUD
especifica o formato de arquivos de origem.
As duas maneiras de especificar o argumento de formato são:
format => '{"format_option" : “format_value” }'
E:
format => json_object('format_option' value 'format_value'))
Exemplos de:
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 opções de formato Avro, ORC ou Parquet, consulte DBMS_CLOUD Opções de Formato do 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 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 o 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 caracteres |
Só use 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 formato JSON e |
Array JSON de expressões de caminho json expressas em formato de string. Por exemplo: valor 'columnpath' |
Opção válida com dados JSON |
Especifica o tipo de compactação do arquivo de origem. O formato de arquivamento ZIP não é suportado. A especificação do valor |
Valor padrão: O valor nulo significa sem 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 da tabela. Detecte a ordem dos campos usando a primeira linha de cada arquivo de dados externo e mapeie-a para as colunas da tabela. Os nomes dos campos nos arquivos de dados externos são comparados de forma diferenciada entre maiúsculas e minúsculas com os nomes das colunas da tabela. Esta opção de formato é aplicável para os seguintes procedimentos:
Restrições para
Consulte FIELD NAMES 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 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 (objeto binário grande) especificado. |
|
Os dados podem ser colocados entre dois delimitadores, especificados com Por exemplo: format => JSON_OBJECT(‘quote’ value ‘(’, ‘endquote’ value ‘)’) |
Valor padrão: Nulo, o que significa 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 de 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. Esta opção só é válida para dados de coleção 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 o mongo. Se não for especificado, o sistema Oracle gerará um ID de sistema exclusivo de 12 bytes e preencherá isso 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 no qual os arquivos Por padrã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 as letras maiúsculas são reservadas quando o valor especificado está entre aspas duplas. Por exemplo: format => JSON_OBJECT ('logprefix' value 'TEST') Em seguida, os arquivos de log usam o prefixo |
Valor padrão: |
|
Especifica uma duração inteira positiva, 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 não forem estruturados e a subcláusula Para nomes de objetos que não se baseiam no formato hive, a ordem das colunas especificadas |
|
|
Especifica o caractere de aspas para os campos, os caracteres |
Valor padrão: Nulo significa que não há aspas |
Opção válida com dados JSON |
Especifica o delimitador de registro. Por padrão, Especifique esse 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 Padrões de expressão regulares só são suportados para o nome do arquivo ou 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 Condição REGEXP_LIKE 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 curingas, 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: Formato de timestamp do banco de dados com fuso 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: Formato de timestamp do banco de dados com 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 Se Consulte DBMS_CLOUD Opções de 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 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 Esta opção só é válida para dados de coleção JSON com |
Valor padrão: |
Tópico principal: DBMS_CLOUD Pacote