Configurare i cataloghi

Importante

Azure HDInsight su AKS è stato ritirato il 31 gennaio 2025. Scopri di più attraverso questo annuncio.

È necessario eseguire la migrazione dei carichi di lavoro a Microsoft Fabric o a un prodotto Azure equivalente per evitare la chiusura brusca dei carichi di lavoro.

Importante

Questa funzionalità è attualmente in anteprima. Le condizioni supplementari per l'utilizzo per le anteprime di Microsoft Azure includono termini legali più validi applicabili alle funzionalità di Azure in versione beta, in anteprima o altrimenti non ancora rilasciate nella disponibilità generale. Per informazioni su questa anteprima specifica, vedere informazioni sull'anteprima di Azure HDInsight su AKS. Per domande o suggerimenti sulle funzionalità, inviare una richiesta in AskHDInsight con i dettagli e seguirci per altri aggiornamenti su Azure HDInsight Community.

Ogni cluster Trino viene fornito di default con alcuni cataloghi: system, tpcds, tpch. È possibile aggiungere cataloghi personalizzati allo stesso modo in cui si farebbe con OSS Trino. Inoltre, Trino con HDInsight su AKS consente di archiviare i segreti in Key Vault in modo da non doverli specificare in modo esplicito nel modello ARM.

È possibile aggiungere un nuovo catalogo aggiornando il modello di Resource Manager del cluster, ad eccezione del catalogo hive, che è possibile aggiungere durante la creazione del cluster Trino nel portale di Azure.

Questo articolo illustra come aggiungere un nuovo catalogo al cluster usando il modello ARM. Nell'esempio riportato in questo articolo vengono descritti i passaggi per l'aggiunta di cataloghi di SQL Server e memoria.

Prerequisiti

• Un cluster Trino operativo con HDInsight su AKS.
• Database SQL di Azure.
• Le credenziali di accesso del server SQL di Azure vengono archiviate nei segreti di Key Vault e l'MSI (identità del servizio gestito) assegnata dall'utente collegata al cluster Trino ha ottenuto le autorizzazioni per leggerle. Riferirsi a per archiviare le credenziali in Key Vault e assegnare il ruolo ad MSI.
• Creare modello ARM per il tuo cluster.
• Familiarità con creazione e distribuzione dei modelli ARM.
• Esaminare l'esempio di modello ARM del cluster completo arm-trino-catalog-sample.json.

Procedura per aggiungere il catalogo al modello ARM

1. Collegare Key Vault e aggiungere segreti a secretsProfile sotto la proprietà clusterProfile.

   In questo passaggio è necessario assicurarsi che Key Vault e i segreti siano configurati per il cluster Trino. Nell'esempio seguente le credenziali di SQL Server vengono archiviate in questi segreti: trinotest-admin-user, 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. Aggiungere cataloghi a serviceConfigsProfiles nella proprietà clusterProfile.

   In questo passaggio è necessario aggiungere al cluster una configurazione del catalogo specifica di Trino. Nell'esempio seguente vengono configurati due cataloghi usando i connettori Memory e SQL Server. La configurazione del catalogo può essere specificata in due modi diversi:

   • Coppie chiave-valore nella sezione valori.
   • Stringa singola nella proprietà del contenuto.

   Il catalogo di memoria viene definito usando la coppia chiave-valore e il catalogo di SQL Server viene definito usando un'opzione a stringa singola.

    "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"
                        },
                    ]
                }
            ]
        }
    ],
   

   Proprietà

   Proprietà	Descrizione
   serviceName	trino
   componente	Identifica che la sezione configura i cataloghi; deve chiamarsi "cataloghi".
   file	Elenco dei file di catalogo Trino da aggiungere al cluster.
   nome del file	Elenco dei file di catalogo Trino da aggiungere al cluster.
   contenuto	json stringa di escape da inserire nel file di catalogo di Trino. Questa stringa deve contenere tutte le proprietà del catalogo specifiche del trino, che dipendono dal tipo di connettore usato. Per altre informazioni, vedere la documentazione di OSS trino.
   ${SECRET_REF:<referenceName>}	Tag speciale per fare riferimento a un segreto da secretsProfile. Trino in fase di esecuzione recupera il segreto da Key Vault e lo sostituisce nella configurazione del catalogo.
   valori	È possibile specificare la configurazione del catalogo usando la proprietà content come singola stringa e usando coppie chiave-valore separate per ogni singola proprietà del catalogo Trino, come illustrato per il catalogo di memoria.

Distribuire il modello di Resource Manager aggiornato per riflettere le modifiche nel cluster. Informazioni su come distribuire un modello ARM.