Consulta de datos particionados externo (con cláusula de partición)

Si desea consultar varios archivos de datos en el almacén de objetos como una única tabla externa y los archivos se pueden representar como varias particiones lógicas, se recomienda utilizar una tabla particionada externa. El uso de una tabla particionada externa conserva la partición lógica de los archivos de datos para el acceso a las consultas. Utilice el procedimiento DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE para crear una tabla particionada externa.

1. Almacene las credenciales del almacén de objetos mediante el procedimiento DBMS_CLOUD.CREATE_CREDENTIAL.

   Por ejemplo:

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

   No es necesario crear una credencial para acceder al almacén de objetos de Oracle Cloud Infrastructure si activa las credenciales de entidad de recurso. Consulte Uso de la entidad de recurso para acceder a los Recursos de Oracle Cloud Infrastructure para obtener más información.

   Esta operación almacena las credenciales en la base de datos en un formato cifrado. Puede utilizar cualquier nombre para el nombre de credencial. Tenga en cuenta que este paso solo es necesario una vez, a menos que cambien las credenciales del almacén de objetos. Una vez almacenadas las credenciales, puede utilizar el mismo nombre de credencial para crear tablas externas.

   Consulte Procedimiento CREATE_CREDENTIAL para obtener información sobre los parámetros username y password para diferentes servicios de almacenamiento de objetos.

2. Cree una tabla particionada externa encima de los archivos de origen mediante el procedimiento DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE.

   El procedimiento DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE admite archivos particionados externos en los servicios de almacenamiento de objetos en la nube soportados. La credencial es una propiedad de nivel de tabla; los archivos externos deben estar en el mismo almacén de objetos.

   Por ejemplo:

   BEGIN
     DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE(
         table_name =>'PET1',  
         credential_name =>'DEF_CRED_NAME',
         format => json_object('delimiter' value ',', 'recorddelimiter' value 'newline', 'characterset' value 'us7ascii'),  
         column_list => 'col1 number, col2 number, col3 number',
         partitioning_clause => 'partition by range (col1)
            (partition p1 values less than (1000) location
                ( ''https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/file_11.txt''),
             partition p2 values less than (2000) location 
                ( ''https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/file_21.txt''),
             partition p3 values less than (3000) location 
                ( ''https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/file_31.txt'') )'
        );
   END;
   / 
   

   Los parámetros son:

   • table_name: es el nombre de la tabla externa.

   • credential_name: es el nombre de la credencial creada en el paso anterior.

   • partitioning_clause: es la cláusula de partición completa, incluida la información de ubicación de las particiones individuales.

   • format: define las opciones que puede especificar para describir el formato del archivo fuente. formato: define las opciones que puede especificar para describir el formato del archivo fuente.

     Si los datos de los archivos de origen están cifrados, descifre los datos especificando el parámetro format con la opción encryption. Consulte Descifrar datos al importar desde Object Storage para obtener más información sobre el descifrado de datos.

   • column_list: es una lista delimitada por comas de las definiciones de columna en los archivos de origen.

   En este ejemplo, namespace-string es el espacio Oracle Cloud Infrastructure Object Storage Namepace, y bucketname es el nombre del cubo. Consulte Descripción de los espacios de nombres de Object Storage para obtener más información.

   Ahora puede ejecutar consultas en la tabla particionada externa que ha creado en el paso anterior. Su instancia de Autonomous Database aprovecha la información de partición de la tabla particionada externa, lo que garantiza que la consulta solo acceda a los archivos de datos relevantes del almacén de objetos. Por ejemplo, la siguiente consulta solo lee archivos de datos de la partición P1:

   SELECT * FROM pet1 WHERE col1 < 750;

   Las tablas particionadas externas que cree con DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE incluyen dos columnas invisibles file$path y file$name. Estas columnas ayudan a identificar de qué archivo procede un registro. Consulte Columnas de Metadatos de Tabla Externa para obtener más información.

   Si hay filas en los archivos de origen que no coincidan con las opciones de formato que ha especificado, la consulta informa de un error. Puede utilizar parámetros DBMS_CLOUD, como rejectlimit, para suprimir estos errores. Como alternativa, también puede validar la tabla particionada externa que ha creado para ver los mensajes de error y las filas rechazadas de modo que pueda cambiar la opción de formato según corresponda. Consulte Validación de datos externos y Validación de datos externos particionados para más información.

   Consulte el procedimiento CREATE_EXTERNAL_PART_TABLE para obtener información detallada sobre los parámetros.

   Consulte DBMS_CLOUD URI Formats para obtener más información sobre los servicios de almacenamiento de objetos en la nube soportados.