Gestionar catálogos

• Almacene sus credenciales de almacenamiento de objetos en su instancia de Autonomous Database
• Crear un enlace de base de datos o utilizar un enlace de base de datos existente
• Montar el enlace de base de datos como catálogo

• Nombre de enlace de la base de datos
• Credenciales en la nube necesarias para acceder a los datos

1. Punto final de Iceberg: configure el catálogo de Polaris o Unity mediante la API REST de Iceberg. Esto implica especificar el tipo de catálogo, el URI y la ubicación del almacén. Necesitará el punto final REST para su catálogo de Iceberg externo. Esta es la URL que proporciona acceso a los metadatos de Iceberg.

   Ejemplo: https://your-iceberg-catalog.com/api/v1/iceberg

2. Punto final de token: los catálogos de REST de Iceberg proporcionan el punto final /v1/oauth/tokens para emitir el token de portador.
3. ID de cliente y secreto de cliente: son credenciales proporcionadas por el servidor OAuth para identificar la aplicación (en este caso, la integración del catálogo de Unity y Polaris). Utilizará estas credenciales para generar el token de portador.
4. Token de portador: para autenticar solicitudes al punto final de REST de Iceberg, utilizará OAuth con las credenciales de cliente. La herramienta Catálogo llama al punto final del token para recibir el token de portador.
5. Espacio de nombres: un espacio de nombres es equivalente a un esquema de una base de datos. Esta ubicación servirá como repositorio para sus mesas Iceberg dentro del catálogo. Iceberg cataloga las tablas de grupos en espacios de nombres, que se pueden anidar en otros espacios de nombres. La especificación Iceberg admite niveles arbitrarios de anidación.

   Por ejemplo, se podría definir una tabla SALES dentro de un espacio de nombres STORES, que se define en un espacio de nombres RETAIL, que se define en sí mismo dentro de un espacio de nombres CORPORATE. La ubicación de Iceberg de tal mesa sería CORPORATE.RETAIL.STORES.SALES.

CREATE OR REPLACE CATALOG INTEGRATION tabular_catalog_int
  CATALOG_SOURCE = ICEBERG_REST
  TABLE_FORMAT = ICEBERG
  CATALOG_NAMESPACE = 'default'
  REST_CONFIG = (
    CATALOG_URI = 'https://api.tabular.io/ws'
    CATALOG_NAME = '<tabular_warehouse_name>'
  )
  REST_AUTHENTICATION = (
    TYPE = OAUTH
    OAUTH_TOKEN_URI = 'https://api.tabular.io/ws/v1/oauth/tokens'
    OAUTH_CLIENT_ID = '<oauth_client_id>'
    OAUTH_CLIENT_SECRET = '<oauth_secret>'
    OAUTH_ALLOWED_SCOPES = ('catalog')
  )
  ENABLED = TRUE;

1. En la página Catálogo, seleccione Gestionar catálogo. Haga clic en +Add.
2. En el cuadro de diálogo Agregar catálogo, seleccione Catálogo de Iceberg en el separador Origen de catálogo.
   
   
   
   Descripción de la ilustración add-catalog-iceberg.png
   
   

   Haga clic en Siguiente.

3. Especifique los siguientes valores de campo en el separador Origen de catálogo del cuadro de diálogo Agregar catálogo:

   • Nombre de catálogo: introduzca el nombre del catálogo con el que desea montar el catálogo de Iceberg.

     Por ejemplo, Polaris.

   • Tipo de catálogo de Iceberg: seleccione Polaris en el campo desplegable.

   • Punto final del catálogo de Iceberg: especifica la URL de la cuenta del catálogo de Polaris. El punto final del catálogo de Polaris de Snowflake suele tener el formato https://<account_locator>.snowflakecomputing.com/polaris/api/catalog. Para obtener más información sobre los formatos de identificador de cuenta, consulte la documentación de Snowflake.
   • Credencial de catálogo de Iceberg: seleccione una credencial de la lista de credenciales disponibles en la lista desplegable. Si no tiene una credencial, puede crear una. Seleccione Crear credencial. En el cuadro de diálogo Crear credencial, especifique los siguientes valores de campo:
     • Nombre de credencial: introduzca el nombre de la credencial. Por ejemplo, POLARIS_CRED.
       En Obtener nuevo token de portador,

       • Punto final de token de acceso: introduzca el punto final de especificación REST de Iceberg. Esto genera un token de acceso mediante OAuth2 definido como /v1/oauth/tokens.

         Este punto final se ha diseñado para facilitar la autenticación mediante el intercambio de credenciales de cliente (ID de cliente y secreto) para un token de acceso.

         Nota
         
         El punto final /v1/oauth/tokens está en desuso en la versión 1.6.0 de Iceberg y se eliminará en la versión 2.0. En su lugar, se recomienda que confíe en proveedores externos de OAuth2. Consulte Autenticación OAuth para obtener más información.
       • Tipo de otorgamiento: seleccione Credenciales de cliente.
       • ID de cliente: especifique el ID del cliente.
       • Secreto de cliente: especifique el secreto de cliente.
       • Ámbito: PRINCIPAL_ROLE:ALL.

         Haga clic en Obtener token.

         Se rellena el campo Token de portador.

       Haga clic en Crear credencial.

       POLARIS_CRED se muestra como credencial de catálogo de Iceberg.

       
       
       
       Descripción de la ilustración create-credential-polaris.png
       
       
       Nota
       
       

       Las credenciales se almacenan mediante el procedimiento DBMS_CLOUD.CREATE_CREDENTIAL en el backend.

       Para el ejemplo de ejemplo proporcionado anteriormente, el procedimiento sería el siguiente:

       BEGIN
         dbms_cloud.create_credential( 
           credential_name  =>  'POLARIS_CRED',
           username         =>  'BEARER_TOKEN',
           password         =>  '<BEARER_TOKEN_VALUE This is generated using token endpoint, client id, client secret>'
         );
       END;

     
     
     
     Descripción de la ilustración add-polaris-catalog-source.png
     
     

     Esta credencial permite a Oracle Autonomous Database acceder a la tabla Iceberg.

   • Credenciales de cubo: esta credencial almacena un volumen de almacenamiento en la nube para almacenar las tablas Iceberg en formato Parquet. Este campo es obligatorio para los catálogos Polaris.

     Haga clic en Siguiente para continuar con el separador Catálogo de Iceberg.

4. En el separador Catálogo de Iceberg, puede especificar los siguientes valores de campo:

   • Espacios de nombres de catálogo de Iceberg: este campo muestra la organización jerárquica de las tablas. El punto final del catálogo de Iceberg consta del espacio de nombres raíz. Seleccione el espacio de nombres en el que desea que se monte el catálogo.
   • Estilo de separador de espacio de nombres: seleccione Estilo de polarización. Éste es el valor por defecto. Seleccione cualquier valor en función de la configuración del catálogo.
     Nota
     
     Se prefiere que mantenga el valor por defecto.
   • Región de cubo: introduzca la región de cubo. Por ejemplo, us-west-2.

     Los puntos finales del catálogo Iceberg sirven como interfaces para gestionar las tablas Iceberg almacenadas en el almacenamiento en la nube como S3. La región de cubo hace referencia a la ubicación geográfica donde se aloja el cubo S3.

     Este campo es obligatorio para los catálogos Polaris.

     
     
     
     Descripción de la ilustración namespace-polaris.png
     
     

   Haga clic en Agregar.

   Después de montar correctamente un nuevo catálogo sobre un catálogo de Iceberg, puede ver el catálogo de Polaris en la página Gestionar catálogos. Puede desactivar y suprimir el catálogo desde esta página.

   
   
   
   Descripción de la ilustración manage-polaris-catalogs.png
   
   

1. En la herramienta Catálogo, haga clic en Seleccionar catálogos....
2. Haga clic en el filtro POLARIS _CATALOG del asistente Catálogos y esquemas para mostrar los catálogos POLARIS_CATALOG.
3. Haga clic en Aplicar para ver los resultados en la página Catálogo.
   
   
   
   Descripción de la ilustración catálogos-esquemas-polaris-catalog.png
   
   

1. En la página Catálogo, seleccione Gestionar catálogo. Haga clic en +Add.
2. En el cuadro de diálogo Agregar catálogo, seleccione Catálogo de Iceberg.
   
   
   
   Descripción de la ilustración add-catalog-iceberg.png
   
   
3. Haga clic en Siguiente.
4. Especifique los siguientes valores de campo en el separador Origen de catálogo del cuadro de diálogo Agregar catálogo:
   • Nombre de catálogo: introduzca el nombre del catálogo con el que desea montar el catálogo de Iceberg.

     Por ejemplo, Unidad.

   • Tipo de catálogo de Iceberg: seleccione Unidad en el campo desplegable.
   • Punto final del catálogo de Iceberg:

     Para Unity Catalog, normalmente se utiliza la API de REST de Databricks. El punto final para acceder a las tablas Iceberg mediante el catálogo de Unity suele tener el formato https://<databricks-instance-url>/api/2.1/unity-catalog/iceberg.

     Nota
     
     Consulte https://docs.databricks.com/aws/en/external-access/iceberg para obtener más información.
   • Credencial de catálogo de Iceberg: seleccione una credencial de la lista de credenciales disponibles en la lista desplegable. Si no tiene una credencial, puede crear una. Seleccione Crear credencial.
     En el cuadro de diálogo Crear credencial, especifique los siguientes valores:

     • Nombre de credencial: introduzca el nombre de la credencial. Por ejemplo, UNITY_CRED.
     • Token de portador: pegue el valor del token de portador.

       Seleccione Crear credencial.

       UNITY_CRED se muestra como credencial de catálogo de Iceberg.

     
     
     
     Descripción de la ilustración add-unity-catalog.png
     
     

     Haga clic en Siguiente para continuar con el separador Catálogo de Iceberg.

     En el separador Catálogo de Iceberg, puede especificar los siguientes valores de campo:

   • Espacios de nombres de catálogo de Iceberg: seleccione cualquiera de los esquemas a los que necesite acceder.
   • Estilo de separador de espacios de nombres: el estilo de separador de espacios de nombres suele hacer referencia a cómo se estructuran y separan los espacios de nombres en el catálogo. De manera predeterminada, se selecciona Estilo de tejidos.
   • Región de cubo: este campo no es obligatorio.
     
     
     
     Descripción de la ilustración iceberg-unity-catalog.png
     
     

     Haga clic en Agregar.

     
     
     
     Descripción de la ilustración manage-unity-catalogs.png
     
     

   Después de montar correctamente un nuevo catálogo sobre un catálogo de Iceberg, puede ver el catálogo de Unity en la página Gestionar catálogos. Puede desactivar y suprimir el catálogo desde esta página.

1. En la herramienta Catálogo, haga clic en Seleccionar catálogos….
2. Haga clic en el filtro UNITY _CATALOG del asistente Catálogos y esquemas para mostrar los catálogos UNITY_CATALOG.
   
   
   
   Descripción de la ilustración catálogos-esquemas-unidad-catalog.png
   
   
3. Haga clic en Aplicar para ver los resultados en la página Catálogo.
   
   
   
   Descripción de la ilustración manage-catalogs-unity.png