Mengonfigurasi katalog

Penting

Fitur ini masih dalam mode pratinjau. Ketentuan Penggunaan Tambahan untuk Pratinjau Microsoft Azure mencakup lebih banyak persyaratan hukum yang berlaku untuk fitur Azure yang dalam versi beta, dalam pratinjau, atau belum dirilis ke ketersediaan umum. Untuk informasi tentang pratinjau khusus ini, lihat Azure HDInsight pada informasi pratinjau AKS. Untuk pertanyaan atau saran fitur, kirimkan permintaan di AskHDInsight dengan detail dan ikuti kami untuk pembaruan lebih lanjut di Komunitas Azure HDInsight.

Setiap kluster Trino hadir secara default dengan beberapa katalog - sistem, tpcd, tpch. Anda dapat menambahkan katalog Anda sendiri dengan cara yang sama seperti yang akan Anda lakukan dengan OSS Trino. Selain itu, Trino dengan HDInsight di AKS memungkinkan penyimpanan rahasia di Key Vault sehingga Anda tidak perlu menentukannya secara eksplisit dalam templat ARM.

Anda dapat menambahkan katalog baru dengan memperbarui templat ARM kluster Anda kecuali katalog apache Hive, yang dapat Anda tambahkan selama pembuatan kluster Trino di portal Azure.

Artikel ini menunjukkan bagaimana Anda dapat menambahkan katalog baru ke kluster Anda menggunakan templat ARM. Contoh dalam artikel ini menjelaskan langkah-langkah untuk menambahkan server SQL dan katalog Memori.

Prasyarat

• Kluster Trino operasional dengan HDInsight di AKS.
• Database Azure SQL.
• Login/kata sandi server Azure SQL disimpan di rahasia Key Vault dan MSI yang ditetapkan pengguna yang dilampirkan ke kluster Trino Anda yang diberikan izin untuk membacanya. Lihat kredensial penyimpanan di Key Vault dan tetapkan peran ke MSI.
• Buat templat ARM untuk kluster Anda.
• Keakraban dengan penulisan dan penyebaran templat ARM.
• Tinjau contoh templat ARM kluster lengkap arm-trino-catalog-sample.json.

Langkah-langkah untuk menambahkan katalog dalam templat ARM

1. Lampirkan Key Vault dan tambahkan rahasia ke secretsProfile di bawah clusterProfile properti .

   Dalam langkah ini, Anda perlu memastikan Key Vault dan rahasia dikonfigurasi untuk kluster Trino. Dalam contoh berikut, kredensial server SQL disimpan dalam rahasia ini: 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. Tambahkan katalog ke serviceConfigsProfiles di bawah clusterProfile properti .

   Dalam langkah ini, Anda perlu menambahkan konfigurasi katalog khusus Trino ke kluster. Contoh berikut mengonfigurasi dua katalog menggunakan konektor server Memori dan SQL. Konfigurasi katalog dapat ditentukan dengan dua cara berbeda:

   • Pasangan kunci-nilai di bagian nilai.
   • String tunggal dalam properti konten.

   Katalog memori didefinisikan menggunakan pasangan kunci-nilai dan katalog server SQL didefinisikan menggunakan opsi string tunggal.

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

   Properti

   Properti	Deskripsi
   serviceName	trino
   komponen	Mengidentifikasi bagian tersebut mengonfigurasi katalog, harus "katalog."
   file	Daftar file katalog Trino yang akan ditambahkan ke kluster.
   filename	Daftar file katalog Trino yang akan ditambahkan ke kluster.
   konten	json string escaped untuk dimasukkan ke dalam file katalog trino. String ini harus berisi semua properti katalog khusus trino, yang bergantung pada jenis konektor yang digunakan. Untuk informasi selengkapnya, lihat dokumentasi trino OSS.
   ${SECRET_REF:<referenceName>}	Tag khusus untuk mereferensikan rahasia dari secretsProfile. Trino saat runtime mengambil rahasia dari Key Vault dan menggantinya dalam konfigurasi katalog.
   nilai	Dimungkinkan untuk menentukan konfigurasi katalog menggunakan properti konten sebagai string tunggal, dan menggunakan pasangan kunci-nilai terpisah untuk setiap properti katalog Trino individual seperti yang ditunjukkan untuk katalog memori.

Sebarkan templat ARM yang diperbarui untuk mencerminkan perubahan di kluster Anda. Pelajari cara menyebarkan templat ARM.