Configurare i cataloghi

Importante

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

Ogni cluster Trino viene fornito per impostazione predefinita con pochi cataloghi: system, tpcds, tpch. È possibile aggiungere cataloghi personalizzati allo stesso modo in cui si farebbe con OSS Trino. Inoltre, Trino con HDInsight nel servizio Azure Kubernetes consente di archiviare i segreti in Key Vault in modo da non doverli specificare in modo esplicito nel modello di Resource Manager.

È 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 nella portale di Azure.

Questo articolo illustra come aggiungere un nuovo catalogo al cluster usando il modello di Resource Manager. 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 nel servizio Azure Kubernetes.
• Database SQL di Azure.
• L'account di accesso/password del server SQL di Azure viene archiviato nei segreti di Key Vault e l'identità del servizio gestito assegnata dall'utente collegata al cluster Trino ha concesso le autorizzazioni per leggerle. Vedere Archiviare le credenziali in Key Vault e assegnare il ruolo a MSI.
• Creare un modello di Resource Manager per il cluster.
• Familiarità con la creazione e la distribuzione di modelli di Resource Manager.
• Esaminare l'esempio di modello arm del cluster completo arm-trino-catalog-sample.json.

Procedura per aggiungere il catalogo nel modello di Resource Manager

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

   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 in 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
   component	Identifica che la sezione configura i cataloghi, deve essere "cataloghi".
   files	Elenco dei file di catalogo Trino da aggiungere al cluster.
   filename	Elenco dei file di catalogo Trino da aggiungere al cluster.
   content	json stringa di escape da inserire nel file di catalogo 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.
   ${edizione Standard CRET_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 di Resource Manager.