Freigeben über

Konfigurieren von Katalogen

  • Artikel

Hinweis

Azure HDInsight on AKS wird am 31. Januar 2025 eingestellt. Vor dem 31. Januar 2025 müssen Sie Ihre Workloads zu Microsoft Fabric oder einem gleichwertigen Azure-Produkt migrieren, um eine abruptes Beendigung Ihrer Workloads zu vermeiden. Die verbleibenden Cluster in Ihrem Abonnement werden beendet und vom Host entfernt.

Bis zum Einstellungsdatum ist nur grundlegende Unterstützung verfügbar.

Wichtig

Diese Funktion steht derzeit als Vorschau zur Verfügung. Die zusätzlichen Nutzungsbedingungen für Microsoft Azure-Vorschauen enthalten weitere rechtliche Bestimmungen, die für Azure-Features in Betaversionen, in Vorschauversionen oder anderen Versionen gelten, die noch nicht allgemein verfügbar gemacht wurden. Informationen zu dieser spezifischen Vorschau finden Sie unter Informationen zur Vorschau von Azure HDInsight on AKS. Bei Fragen oder Funktionsvorschlägen senden Sie eine Anfrage an AskHDInsight mit den entsprechenden Details, und folgen Sie uns für weitere Updates in der Azure HDInsight-Community.

Jeder Trino-Cluster verfügt standardmäßig mit wenigen Katalogen: system, tpcds und tpch. Sie können Ihre eigenen Kataloge auf die gleiche Weise hinzufügen, wie Sie es mit OSS-Trino tun würden. Darüber hinaus ermöglicht Trino mit HDInsight on AKS das Speichern von Geheimnissen in Key Vault, sodass Sie sie nicht explizit in der ARM-Vorlage angeben müssen.

Sie können einen neuen Katalog hinzufügen, indem Sie Ihre Cluster-ARM-Vorlage – außer dem Strukturkatalog – aktualisieren, den Sie während der Trino-Clustererstellung im Azure-Portal hinzufügen können.

In diesem Artikel wird veranschaulicht, wie Sie Ihrem Cluster mithilfe einer ARM-Vorlage einen neuen Katalog hinzufügen. Im Beispiel in diesem Artikel werden die Schritte zum Hinzufügen von SQL Server- und Memory-Katalogen beschrieben.

Voraussetzungen

Schritte zum Hinzufügen eines Katalogs in der ARM-Vorlage

  1. Fügen Sie Key Vault an, und fügen Sie Geheimnisse secretsProfile unter der Eigenschaft clusterProfile hinzu.

    In diesem Schritt müssen Sie sicherstellen, dass Key Vault und Geheimnisse für Trino-Cluster konfiguriert sind. Im folgenden Beispiel werden SQL Server-Anmeldeinformationen in diesen Geheimnissen gespeichert: trinotest-admin-user und 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. Fügen Sie Kataloge zu serviceConfigsProfiles unter der Eigenschaft clusterProfile hinzu.

    In diesem Schritt müssen Sie dem Cluster Trino-spezifische Katalogkonfiguration hinzufügen. Im folgenden Beispiel werden zwei Kataloge mit Memory- und SQL Server-Connectors konfiguriert. Die Katalogkonfiguration kann auf zwei verschiedene Arten angegeben werden:

    • Schlüssel-Wert-Paare im Werteabschnitt
    • Einzelne Zeichenfolgen in der Inhaltseigenschaft

    Der Memory-Katalog wird mithilfe eines Schlüssel-Wert-Paars und der SQL Server-Katalog mit einer einzelnen Zeichenfolgenoption definiert.

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

    Eigenschaften

    Eigenschaften Beschreibung
    serviceName Trino
    Komponente Gibt an, dass dieser Abschnitt Kataloge konfiguriert, muss Kataloge “catalogs." lauten
    files Liste der Trino-Katalogdateien, die dem Cluster hinzugefügt werden sollen
    filename Liste der Trino-Katalogdateien, die dem Cluster hinzugefügt werden sollen
    content json-Zeichenfolge mit Escapezeichen, die in eine Trino-Katalogdatei eingefügt werden soll. Diese Zeichenfolge sollte alle Trino-spezifischen Katalogeigenschaften enthalten, die vom verwendeten Connectortyp abhängen. Weitere Informationen finden Sie in der OSS-Trino-Dokumentation.
    ${SECRET_REF:<referenceName>} Spezielles Tag, um auf ein Geheimnis von secretsProfile zu verweisen. Trino ruft zur Laufzeit das Geheimnis aus Key Vault ab und ersetzt es in der Katalogkonfiguration.
    values Die Katalogkonfiguration kann mithilfe der Inhaltseigenschaft als einzelne Zeichenfolge und mit separaten Schlüssel-Wert-Paare für jede einzelne Trino-Katalogeigenschaft angegeben werden, wie für den Memory-Katalog gezeigt.

Stellen Sie die aktualisierte ARM-Vorlage bereit, um die Änderungen in Ihrem Cluster widerzuspiegeln. Erfahren Sie, wie Sie eine ARM-Vorlage bereitstellen.