Compartir vía

Configuración de catálogos

  • Artículo

Nota:

Retiraremos Azure HDInsight en AKS el 31 de enero de 2025. Antes del 31 de enero de 2025, deberá migrar las cargas de trabajo a Microsoft Fabric o un producto equivalente de Azure para evitar la terminación repentina de las cargas de trabajo. Los clústeres restantes de la suscripción se detendrán y quitarán del host.

Solo el soporte técnico básico estará disponible hasta la fecha de retirada.

Importante

Esta funcionalidad actualmente está en su versión preliminar. En Términos de uso complementarios para las versiones preliminares de Microsoft Azure encontrará más términos legales que se aplican a las características de Azure que están en versión beta, en versión preliminar, o que todavía no se han lanzado con disponibilidad general. Para más 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

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.