Configuración de catálogos

Importante

Esta funcionalidad actualmente está en su versión preliminar. Los Términos de uso complementarios para las versiones preliminares de Microsoft Azure incluyen más términos legales que se aplican a las características de Azure que se encuentran en la versión beta, en versión preliminar, o que todavía no se han lanzado con disponibilidad general. Para obtener información sobre esta versión preliminar específica, consulte la Información de Azure HDInsight sobre la versión preliminar de AKS. Para plantear preguntas o sugerencias sobre la característica, envíe una solicitud en AskHDInsight con los detalles y síganos para obtener más actualizaciones sobre Comunidad de Azure HDInsight.

Cada clúster de Trino incorpora de manera predeterminada algunos catálogos: system, tpcds y tpch. Puede agregar sus propios catálogos de la misma manera que lo haría con software de código abierto de Trino. Además, Trino con HDInsight en AKS permite almacenar secretos en Key Vault para que no tenga que especificarlos explícitamente en la plantilla de ARM.

Puede agregar un nuevo catálogo actualizando la plantilla de ARM del clúster, excepto el catálogo de Hive, que puede agregar durante la creación del clúster de Trino en Azure Portal.

En este artículo, se muestra cómo puede agregar un nuevo catálogo al clúster mediante una plantilla de ARM. En el ejemplo de este artículo, se describen los pasos para agregar catálogos de SQL Server y en memoria.

Requisitos previos

• Un clúster operativo de Trino con HDInsight en AKS.
• Azure SQL Database.
• El inicio de sesión y la contraseña del servidor de Azure SQL se almacenan en los secretos de Key Vault y la MSI asignada por el usuario asociadas al clúster de Trino, concediendo permisos para leerlos. Consulte Almacenamiento de credenciales en Key Vault y asignación de un rol a MSI.
• Cree una plantilla de ARM para el clúster.
• Familiaridad con la creación e implementación de plantillas de ARM.
• Revise el ejemplo de plantilla de ARM de clúster completo arm-trino-catalog-sample.json.

Pasos para agregar catálogos en la plantilla de ARM

1. Conecte Key Vault y agregue secretos a secretsProfile en la propiedad clusterProfile.

   En este paso, debe asegurarse de que Key Vault y los secretos estén configurados para el clúster de Trino. En el ejemplo siguiente, las credenciales de SQL Server se almacenan en estos secretos: trinotest-admin-user y trinotest-admin-pwd.

   "secretsProfile": {
       "keyVaultResourceId": "/subscriptions/{USER_SUBSCRIPTION_ID}/resourceGroups/{USER_RESOURCE_GROUP}/providers/Microsoft.KeyVault/vaults/{USER_KEYVAULT_NAME}",
       "secrets": [
           {
               "referenceName": "trinotest-admin-user",
               "keyVaultObjectName": "trinotest-admin-user",
               "type": "secret"
           },
           {
               "referenceName": "trinotest-admin-pwd",
               "keyVaultObjectName": "trinotest-admin-pwd",
               "type": "secret"
           }
       ]
   },
   

2. Agregue catálogos a serviceConfigsProfiles en la propiedad clusterProfile.

   En este paso, debe agregar la configuración de catálogo específica de Trino al clúster. En el ejemplo siguiente, se configuran dos catálogos mediante conectores de memoria y SQL Server. La configuración del catálogo se puede especificar de dos maneras diferentes:

   • Pares clave-valor en la sección de valores.
   • Cadena única en la propiedad de contenido.

   El catálogo de memoria se define mediante el par clave-valor y el catálogo de SQL Server se define mediante la opción de cadena única.

    "serviceConfigsProfiles": [
        {
            "serviceName": "trino",
            "configs": [
                {
                    "component": "catalogs",
                    "files": [
                            {
                            "fileName": "memory.properties",
                            "values": {
                                "connector.name": "memory",
                                "memory.max-data-per-node": "128MB"
                            }
                        },
                        {
                            "fileName": "trinotestdb1.properties",
                            "content":"connector.name=sqlserver\nconnection-url=jdbc:sqlserver://server-name.database.windows.net:1433;database=db1;encrypt=true;trustServerCertificate=false;hostNameInCertificate=*.database.windows.net;loginTimeout=30;\nconnection-user=${SECRET_REF:trinotest-admin-user}\nconnection-password=${SECRET_REF:trinotest-admin-pwd}\n"
                        },
                    ]
                }
            ]
        }
    ],
   

   Propiedades

   Property	Descripción
   serviceName	trino
   Componente	Identifica que la sección que configura los catálogos debe ser “catalogs".
   files	Lista de archivos de catálogo de Trino que se van a agregar al clúster.
   filename	Lista de archivos de catálogo de Trino que se van a agregar al clúster.
   content	Cadena de escape json que se va a colocar en el archivo de catálogo de Trino. Esta cadena debe contener todas las propiedades del catálogo específicas de Trino, que dependen del tipo de conector utilizado. Para obtener más información, consulte la documentación del software de código abierto Trino.
   ${SECRET_REF:<referenceName>}	Etiqueta especial para hacer referencia a un secreto de secretsProfile. Trino captura en tiempo de ejecución el secreto de Key Vault y lo sustituye en la configuración del catálogo.
   valores	Es posible especificar la configuración del catálogo mediante la propiedad content como una sola cadena y usar pares clave-valor independientes para cada propiedad individual del catálogo de Trino, como se muestra para el catálogo de memoria.

Implemente la plantilla de ARM actualizada para reflejar los cambios en el clúster. Obtenga información sobre cómo implementar una plantilla de ARM.