Compartir a través de

Configuración de la extensión de Azure Storage en Azure Database for PostgreSQL

Debe seguir estos pasos para poder usar la extensión de Azure Storage:

  1. Identificación de cuentas de Azure Storage
  2. Elección del tipo de autorización
  3. Cargar la biblioteca de la extensión
  4. Lista de permitidos de la extensión
  5. Creación de la extensión
  6. Uso de la extensión para importar y exportar datos

Identificación de las cuentas de Azure Storage

Identifique las cuentas de Azure Storage con las que desea que los usuarios de la extensión interactúen, para importar o exportar datos.

Elección del tipo de autorización

Decida qué tipo de autorización desea usar para las solicitudes realizadas en el servicio de blobs de cada una de esas cuentas de Azure Storage. azure_storage la extensión admite la autorización con clave compartida y la autorización con el identificador de Microsoft Entra.

De estos dos tipos de autorización, Microsoft Entra ID proporciona una seguridad superior y facilidad de uso en clave compartida, y es la que Microsoft recomienda.

Para cumplir los requisitos previos necesarios en cada caso, siga las instrucciones de las secciones correspondientes:

Para usar la autorización con el identificador de Entra de Microsoft

  1. Habilite la identidad administrada asignada por el sistema en la instancia de servidor flexible de Azure Database for PostgreSQL.
  2. Reinicie la instancia del servidor flexible de Azure Database for PostgreSQL después de habilitar una identidad administrada asignada por el sistema.
  3. Asigne permisos de control de acceso basado en rol (RBAC) para el acceso a datos de blobs, en la cuenta de Azure Storage, a la identidad administrada asignada por el sistema de la instancia del servidor flexible de Azure Database for PostgreSQL.

Habilitación de la identidad administrada asignada por el sistema

Captura de pantalla de la habilitación de la identidad administrada asignada por el sistema.

Para usar la autorización con clave compartida

  1. Confirmación de que la cuenta de almacenamiento permite el acceso a su clave
  2. Captura de una de las dos claves de acceso de la cuenta de almacenamiento

Confirmación de que la cuenta de almacenamiento permite el acceso a su clave

La cuenta de Azure Storage debe tener habilitada la opción Permitir el acceso a la clave de la cuenta de almacenamiento (es decir, no puede tener la propiedad AllowSharedKeyAccess establecida en false).

Captura de pantalla de la confirmación de que la opción Permitir el acceso a la clave de la cuenta de almacenamiento está habilitada.

Captura de una de las dos claves de acceso de la cuenta de almacenamiento

Para pasarla a la función azure_storage.account_add , capture cualquiera de las dos claves de acceso de la cuenta de Azure Storage.

Captura de pantalla de la copia de la clave de acceso de la cuenta de almacenamiento.

Cargar la biblioteca de la extensión

Configure el servidor para que cargue el azure_storage módulo binario cuando se inicie.

Captura de pantalla de la selección de azure_storage en shared_preload_libraries en los parámetros del servidor. shared_preload_libraries Dado que es estático, el servidor debe reiniciarse para que un cambio surta efecto: captura de pantalla del cuadro de diálogo que aparece al cambiar shared_preload_libraries, para guardar y reiniciar.

Lista de permitidos de la extensión

Debe permitir incluir la extensión para que los usuarios puedan ejecutar CREATE EXTENSION, DROP EXTENSION, ALTER EXTENSION, COMMENT ON EXTENSION.

Captura de pantalla de la selección de azure_storage en azure.extensions en parámetros de servidor.

Creación de la extensión

Use el cliente de su preferencia, como PostgreSQL para Visual Studio Code (versión preliminar),psql o PgAdmin, para conectarse a la base de datos en la que desea usar la extensión de Azure Storage.

Para crear todos los objetos SQL (tablas, tipos, funciones, vistas, etc.) con los que puede usar la azure_storage extensión para interactuar con instancias de cuentas de Azure Storage, ejecute la siguiente instrucción:

CREATE EXTENSION azure_storage;

Uso de la extensión para importar y exportar datos

Ahora está listo para agregar las cuentas de almacenamiento con las que desea interactuar (mediante la azure_storage.account_add función ). A continuación, puede importar datos almacenados en archivos en cuentas de Azure Storage mediante la azure_storage.blob_get función o la COPY FROM instrucción , o bien puede exportar datos de PostgreSQL a archivos de una cuenta de Azure Storage mediante la azure_storage.blob_put función o la COPY TO instrucción .

Consulte la lista de ejemplos de inicio rápido:

En caso de que necesite revisar todas las funciones que ofrece la extensión y todos los detalles sobre cada una de ellas, revise la referencia completa:

Y, si necesita realizar alguna solución de problemas, revise la lista de errores que puede generar la extensión y el contexto en el que se pueden generar.

Importante

Para los tipos de autenticación para los que debe proporcionar una clave de acceso de la cuenta de Azure Storage, tenga en cuenta que las claves de acceso de Azure Storage son similares a una contraseña raíz para la cuenta de almacenamiento. Siempre tenga cuidado de protegerlos. Use Azure Key Vault para administrar y rotar las claves de forma segura. azure_storage la extensión almacena esas claves en una tabla azure_storage.accounts, que los miembros del pg_read_all_data rol pueden leer.

Contenido relacionado

  • Last updated on