تكوين الكتالوجات

هام

هذه الميزة في وضع المعاينة حاليًا. تتضمن شروط الاستخدام التكميلية لمعاينات Microsoft Azure المزيد من الشروط القانونية التي تنطبق على ميزات Azure الموجودة في الإصدار التجريبي أو قيد المعاينة أو التي لم يتم إصدارها بعد في التوفر العام. للحصول على معلومات حول هذه المعاينة المحددة، راجع معلومات معاينة Azure HDInsight على AKS. للأسئلة أو اقتراحات الميزات، يرجى إرسال طلب على AskHDInsight مع التفاصيل ومتابعتنا لمزيد من التحديثات على مجتمع Azure HDInsight.

تأتي كل مجموعة Trino بشكل افتراضي مع عدد قليل من الكتالوجات - النظام، tpcds، tpch. يمكنك إضافة الكتالوجات الخاصة بك بنفس الطريقة التي تفعلها مع OSS Trino. بالإضافة إلى ذلك، يسمح Trino مع HDInsight على AKS بتخزين الأسرار في Key Vault حتى لا تضطر إلى تحديدها بشكل صريح في قالب ARM.

يمكنك إضافة كتالوج جديد عن طريق تحديث قالب ARM لنظام المجموعة باستثناء كتالوج الخلية، والذي يمكنك إضافته أثناء إنشاء مجموعة Trino في مدخل Microsoft Azure.

توضح هذه المقالة كيف يمكنك إضافة كتالوج جديد إلى نظام المجموعة باستخدام قالب ARM. يصف المثال في هذه المقالة خطوات إضافة كتالوجات SQL server وذاكرة.

المتطلبات الأساسية

• مجموعة Trino تشغيلية مع HDInsight على AKS.
• قاعدة بيانات Azure SQL.
• يتم تخزين تسجيل الدخول/كلمة المرور لخادم Azure SQL في أسرار Key Vault وMSI المعينة من قبل المستخدم والمرفقة بمجموعة Trino الخاصة بك التي تم منحها أذونات لقراءتها. ارجع إلى بيانات اعتماد المخزن في Key Vault وقم بتعيين دور إلى MSI.
• إنشاء قالب ARM للمجموعة الخاصة بك.
• الإلمام بتأليف قالب ARM ونشره.
• مراجعة مثال قالب ARM لنظام المجموعة الكامل arm-trino-catalog-sample.json.

خطوات لإضافة كتالوج في قالب ARM

1. إرفاق Key Vault وإضافة أسرار إلى secretsProfile ضمن clusterProfile الخاصية .

   في هذه الخطوة، تحتاج إلى التأكد من تكوين Key Vault والأسرار لمجموعة Trino. في المثال التالي، يتم تخزين بيانات اعتماد خادم SQL في هذه الأسرار: 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. إضافة كتالوجات إلى serviceConfigsProfiles ضمن clusterProfile الخاصية .

   في هذه الخطوة، تحتاج إلى إضافة تكوين كتالوج Trino محدد إلى نظام المجموعة. يقوم المثال التالي بتكوين كتالوجين باستخدام موصلات الذاكرة وخادم SQL. قد يتم تحديد تكوين الكتالوج بطريقتين مختلفتين:

   • أزواج قيم المفاتيح في قسم القيم.
   • سلسلة مفردة في خاصية المحتوى.

   يتم تعريف كتالوج الذاكرة باستخدام زوج قيم المفاتيح ويتم تعريف كتالوج خادم SQL باستخدام خيار سلسلة واحدة.

    "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://mysqlserver1.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"
                        },
                    ]
                }
            ]
        }
    ],
   

   الخصائص

   الخاصية	‏‏الوصف
   serviceName	trino
   مكون	يحدد هذا القسم الذي يقوم بتكوين الكتالوجات، يجب أن يكون "كتالوجات".
   الملفات	قائمة ملفات كتالوج Trino المراد إضافتها إلى نظام المجموعة.
   filename	قائمة ملفات كتالوج Trino المراد إضافتها إلى نظام المجموعة.
   المحتوى	json سلسلة مهربة لوضعها في ملف كتالوج trino. يجب أن تحتوي هذه السلسلة على جميع خصائص الكتالوج الخاصة ب trino، والتي تعتمد على نوع الموصل المستخدم. لمزيد من المعلومات، راجع وثائق OSS trino.
   ${SECRET_REF:<referenceName>}	علامة خاصة للإشارة إلى سر من secretsProfile. أحضر Trino في وقت التشغيل السر من Key Vault واستبدله في تكوين الكتالوج.
   القيم	من الممكن تحديد تكوين الكتالوج باستخدام خاصية المحتوى كسلسلة واحدة، واستخدام أزواج منفصلة من قيم المفاتيح لكل خاصية كتالوج Trino فردية كما هو موضح في كتالوج الذاكرة.

انشر قالب ARM المحدث ليعكس التغييرات في نظام المجموعة. تعرف على كيفية نشر قالب ARM.