No Autonomous Database, use o procedimento DBMS_CLOUD.CREATE_EXTERNAL_TABLE para criar tabelas externas particionadas implícitas com base em dados particionados no estilo Hive ou de pasta simples armazenados no Armazenamento de Objetos na Nuvem.

Use o procedimento DBMS_CLOUD.CREATE_EXTERNAL_TABLE para criar tabelas externas particionadas implícitas. Ao passar as opções apropriadas para este procedimento, as partições são derivadas dos dados de origem. As tabelas externas particionadas suportam a descoberta de runtime de colunas de partição e seus valores. A descoberta de runtime de alterações na estrutura de armazenamento de objetos subjacente, como adicionar ou remover objetos, simplifica o processo de manutenção eliminando a necessidade de procedimentos de sincronização adicionais exigidos pelo DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE. Isso garante que os dados estejam atualizados no tempo de execução da consulta.

Com particionamento implícito, o Autonomous Database determina automaticamente as colunas nas quais uma tabela é "particionada" com base na estrutura de arquivos hierárquicos da origem de armazenamento de objetos. Não há necessidade de declarar explicitamente um esquema de particionamento. O particionamento implícito oferece benefícios de desempenho semelhantes a tabela de partição sem a necessidade de definir explicitamente uma tabela externa particionada usando o procedimento DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE.

Tabelas externas particionadas implícitas suportam os seguintes estilos de nomeação para objetos particionados no armazenamento de objetos:

• Formato de Nomeação do Hive: Os dados no armazenamento de objetos que foram gerados no Hive têm o seguinte formato.

  OBJBUCKET/<table>/<partcol1>=<value1>/<partcol2>=<value2>/file.parquet

  Para obter um exemplo, consulte Query External Implicit Partitioned Data with Hive Format Source File Organization

• Formato de Nomeação "Pathtail" não Hive: Um segundo formato que geralmente é encontrado em data lakes é semelhante ao formato hive, mas o nome da pasta não inclui as colunas de partição.

  OBJBUCKET/<table>/<value1>/<value2>/file.parquet

  Para obter um exemplo, consulte Consultar Dados de Estilo Não Hive Particionados Implícitos Externos.

Para obter mais informações sobre formatos de nomeação, consulte Sobre Tabelas Externas com Particionamento de Arquivo de Origem.

Consulte Procedimento CREATE_EXTERNAL_TABLE para obter informações adicionais.

Use o procedimento DBMS_CLOUD.CREATE_EXTERNAL_TABLE para criar uma tabela externa particionada implícita com base nos dados do Armazenamento de Objetos que foram gerados com base nos dados do Hive.

1. Armazene as credenciais de Armazenamento de Objetos usando o procedimento DBMS_CLOUD.CREATE_CREDENTIAL.

   Por exemplo:

   BEGIN
     DBMS_CLOUD.CREATE_CREDENTIAL (
       credential_name => 'DEF_CRED_NAME',
       username => 'adb_user@example.com',
       password => 'password' );
   END;
   /

   A criação de uma credencial para acessar o Oracle Cloud Infrastructure Object Store não será necessária se você ativar credenciais do controlador de recursos. Consulte Usar o Controlador de Recursos para Acessar Recursos do Oracle Cloud Infrastructure para obter mais informações.

   Essa operação armazena as credenciais no banco de dados em um formato criptografado. Você pode usar qualquer nome para a credencial. Observe que essa etapa só é necessária uma vez, a menos que suas credenciais de armazenamento de objetos sejam alteradas. Depois de armazenar as credenciais, você poderá usar o mesmo nome de credencial para criar tabelas externas.

   Consulte Procedimento CREATE_CREDENTIAL para obter informações sobre os parâmetros username e password para diferentes serviços de armazenamento de objetos.

2. Crie uma tabela externa partição implícita na parte superior dos arquivos de origem usando o procedimento DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE.
   Neste exemplo, como a opção de formato implicit_partition_columns não é fornecida, as colunas de partição são detectadas automaticamente e o particionamento implícito é ativado definindo a opção de formato implicit_partition_type como hive.

   No entanto, se for fornecida uma lista de colunas, essas colunas serão usadas como colunas de partição e o Autonomous Database não tentará descobrir as colunas.

   Para detectar as colunas de partição que o Autonomous Database inicia a pesquisa no início do caminho, especificado por file_uri_list, para '='. Quando encontrada, a parte esquerda de '=' até o último '/' é tomada como coluna (por exemplo, "país") e a parte direita de '=', até o primeiro '/' como valor (por exemplo, "EUA"). A pesquisa continua por '=' até depois de '/' que segue o primeiro valor de partição, detectando o segundo '=' no caminho e assim por diante.

   DBMS_CLOUD.CREATE_EXTERNAL_TABLE (
      table_name        => 'mysales',
      credential_name   => 'DEF_CRED_NAME',
      file_uri_list     => 'https://swiftobjectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/*.parquet',
      column_list       => 'product varchar2(100), units number, country varchar2(100),year (number), month varchar2(2)',
      format            => '{"type":"parquet", "implicit_partition_type":"hive"');

   Os parâmetros são:

   • table_name: é o nome da tabela externa.

   • credential_name: é o nome da credencial criada na etapa anterior.

   • file_uri_list: é uma lista delimitada por vírgulas dos URIs de arquivo de origem. Há duas opções para essa lista:

     • Especifique uma lista delimitada por vírgulas de URIs de arquivos individuais sem curingas.

     • Especifique um URI de arquivo único com curingas, em que os curingas só podem ser posteriores à última barra "/". O caractere "*" pode ser usado como curinga para vários caracteres, o caractere "?" pode ser usado como curinga para um único caractere.

   • column_list: é uma lista delimitada por vírgulas de nomes de colunas e tipos de dados para a tabela externa. A lista inclui as colunas dentro do arquivo de dados e aquelas derivadas do nome do objeto (dos nomes no caminho do arquivo especificado por file_uri_list).

     O column_list não é obrigatório quando os arquivos de dados são estruturados (Parquet, Avro ou ORC).

   • format: define as opções que você pode especificar para descrever o formato do arquivo de origem. A opção implicit_partition_type especifica o tipo de formato de dados como hive.

     Se os dados em seu arquivo de origem forem criptografados, decriptografe os dados especificando a opção de formato encryption. Consulte Descriptografar Dados ao Importar do Serviço Object Storage para obter mais informações sobre como decriptografar dados.

     Consulte Opções de Formato de Pacote DBMS_CLOUD para obter mais informações.

   Neste exemplo, namespace-string corresponde ao namespace do armazenamento de objetos do Oracle Cloud Infrastructure e bucketname corresponde ao nome do bucket. Consulte Noções Básicas de Namespaces do serviço Object Storage para obter mais informações.

   Consulte CREATE_EXTERNAL_TABLE Procedimento para obter informações detalhadas sobre os parâmetros. Consulte DBMS_CLOUD Formatos de URI para obter mais informações sobre os serviços suportados de armazenamento de objetos da nuvem.

3. Agora você pode executar consultas na tabela particionada externa criada na etapa anterior.

   Seu Autonomous Database aproveita as informações de particionamento da sua tabela particionada externa, garantindo que a consulta só acesse os arquivos de dados relevantes no Armazenamento de Objetos.

   Por exemplo:

   SELECT product, units FROM mysales WHERE year='2024' and month='02'

   Esta instrução SQL consulta apenas dados na partição para o mês 02 do ano de 2024.

Use o procedimento DBMS_CLOUD.CREATE_EXTERNAL_TABLE para criar uma tabela externa particionada implícita com base nos dados do armazenamento de objetos que foram gerados de dados que não são do Hive.

1. Armazene as credenciais de Armazenamento de Objetos usando o procedimento DBMS_CLOUD.CREATE_CREDENTIAL.

   Por exemplo:

   BEGIN
     DBMS_CLOUD.CREATE_CREDENTIAL (
       credential_name => 'DEF_CRED_NAME',
       username => 'adb_user@example.com',
       password => 'password' );
   END;
   /

   A criação de uma credencial para acessar o Oracle Cloud Infrastructure Object Store não será necessária se você ativar credenciais do controlador de recursos. Consulte Usar o Controlador de Recursos para Acessar Recursos do Oracle Cloud Infrastructure para obter mais informações.

   Essa operação armazena as credenciais no banco de dados em um formato criptografado. Você pode usar qualquer nome para a credencial. Observe que essa etapa só é necessária uma vez, a menos que suas credenciais de armazenamento de objetos sejam alteradas. Depois de armazenar as credenciais, você poderá usar o mesmo nome de credencial para criar tabelas externas.

   Consulte Procedimento CREATE_CREDENTIAL para obter informações sobre os parâmetros username e password para diferentes serviços de armazenamento de objetos.

2. Crie uma tabela externa partição implícita na parte superior dos arquivos de origem usando o procedimento DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE.
   Neste exemplo, o particionamento implícito é ativado fornecendo as colunas de partição com a opção de formato implicit_partition_columns. Como o nome da pasta não inclui as colunas de partição, os valores de partição no caminho, especificados por file_uri_list, só poderão ser descobertos se uma lista explícita de colunas for fornecida com a opção de formato implicit_partition_columns. Para detectar os respectivos valores de coluna no caminho, a ordem das colunas deve ser igual à ordem dos valores.

   As colunas de partição são detectadas automaticamente.

   DBMS_CLOUD.CREATE_EXTERNAL_TABLE (
      table_name        => 'mysales',
      credential_name   => 'DEF_CRED_NAME',
      file_uri_list     => 'https://swiftobjectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/*.parquet',
      column_list       => 'product varchar2(100), units number, country varchar2(100),year (number), month varchar2(2)',
      format            => '{"type":"parquet", "implicit_partition_columns":["country","year","month"]}');

   Os parâmetros são:

   • table_name: é o nome da tabela externa.

   • credential_name: é o nome da credencial criada na etapa anterior.

   • file_uri_list: é uma lista delimitada por vírgulas dos URIs de arquivo de origem. Há duas opções para essa lista:

     • Especifique uma lista delimitada por vírgulas de URIs de arquivos individuais sem curingas.

     • Especifique um URI de arquivo único com curingas, em que os curingas só podem ser posteriores à última barra "/". O caractere "*" pode ser usado como curinga para vários caracteres, o caractere "?" pode ser usado como curinga para um único caractere.

   • column_list: é uma lista delimitada por vírgulas de nomes de colunas e tipos de dados para a tabela externa. A lista inclui as colunas dentro do arquivo de dados e aquelas derivadas do nome do objeto (dos nomes no caminho do arquivo especificado por file_uri_list).

     O column_list não é obrigatório quando os arquivos de dados são estruturados (Parquet, Avro ou ORC).

   • format: define as opções que você pode especificar para descrever o formato do arquivo de origem. A opção implicit_partition_type não está definida. Como implicit_partition_columns é fornecido, o tipo é detectado automaticamente como não ativo.

     Se os dados em seu arquivo de origem forem criptografados, decriptografe os dados especificando a opção de formato encryption. Consulte Descriptografar Dados ao Importar do Serviço Object Storage para obter mais informações sobre como decriptografar dados.

     Consulte Opções de Formato de Pacote DBMS_CLOUD para obter mais informações.

   Neste exemplo, namespace-string corresponde ao namespace do armazenamento de objetos do Oracle Cloud Infrastructure e bucketname corresponde ao nome do bucket. Consulte Noções Básicas de Namespaces do serviço Object Storage para obter mais informações.

   Consulte CREATE_EXTERNAL_TABLE Procedimento para obter informações detalhadas sobre os parâmetros.

   Consulte DBMS_CLOUD Formatos de URI para obter mais informações sobre os serviços suportados de armazenamento de objetos da nuvem.

3. Agora você pode executar consultas na tabela particionada externa criada na etapa anterior.

   Seu Autonomous Database aproveita as informações de particionamento da sua tabela particionada externa, garantindo que a consulta só acesse os arquivos de dados relevantes no Armazenamento de Objetos.

   Por exemplo:

   SELECT product, units FROM mysales WHERE year='2024'

   Esta instrução SQL consulta apenas dados na partição para o ano de 2024.