Freigeben über


Microsoft.Kusto cluster/databases/dataConnections 2024-04-13

Bicep-Ressourcendefinition

Der Ressourcentyp cluster/databases/dataConnections kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.Kusto/clusters/databases/dataConnections-Ressource zu erstellen, fügen Sie der Vorlage die folgende Bicep hinzu.

resource symbolicname 'Microsoft.Kusto/clusters/databases/dataConnections@2024-04-13' = {
  location: 'string'
  name: 'string'
  kind: 'string'
  // For remaining properties, see Microsoft.Kusto/clusters/databases/dataConnections objects
}

Microsoft.Kusto/clusters/databases/dataConnections-Objekte

Legen Sie die Art Eigenschaft fest, um den Objekttyp anzugeben.

Verwenden Sie für CosmosDb:

{
  kind: 'CosmosDb'
  properties: {
    cosmosDbAccountResourceId: 'string'
    cosmosDbContainer: 'string'
    cosmosDbDatabase: 'string'
    managedIdentityResourceId: 'string'
    mappingRuleName: 'string'
    retrievalStartDate: 'string'
    tableName: 'string'
  }
}

Verwenden Sie für EventGrid-:

{
  kind: 'EventGrid'
  properties: {
    blobStorageEventType: 'string'
    consumerGroup: 'string'
    databaseRouting: 'string'
    dataFormat: 'string'
    eventGridResourceId: 'string'
    eventHubResourceId: 'string'
    ignoreFirstRecord: bool
    managedIdentityResourceId: 'string'
    mappingRuleName: 'string'
    storageAccountResourceId: 'string'
    tableName: 'string'
  }
}

Verwenden Sie für EventHub-:

{
  kind: 'EventHub'
  properties: {
    compression: 'string'
    consumerGroup: 'string'
    databaseRouting: 'string'
    dataFormat: 'string'
    eventHubResourceId: 'string'
    eventSystemProperties: [
      'string'
    ]
    managedIdentityResourceId: 'string'
    mappingRuleName: 'string'
    retrievalStartDate: 'string'
    tableName: 'string'
  }
}

Verwenden Sie für IotHub-:

{
  kind: 'IotHub'
  properties: {
    consumerGroup: 'string'
    databaseRouting: 'string'
    dataFormat: 'string'
    eventSystemProperties: [
      'string'
    ]
    iotHubResourceId: 'string'
    mappingRuleName: 'string'
    retrievalStartDate: 'string'
    sharedAccessPolicyName: 'string'
    tableName: 'string'
  }
}

Eigenschaftswerte

CosmosDbDataConnection

Name Beschreibung Wert
Art Art des Endpunkts für die Datenverbindung 'CosmosDb' (erforderlich)
Eigenschaften Die Eigenschaften der CosmosDb-Datenverbindung. CosmosDbDataConnectionProperties

CosmosDbDataConnectionProperties

Name Beschreibung Wert
cosmosDbAccountResourceId Die Ressourcen-ID des Cosmos DB-Kontos, das zum Erstellen der Datenverbindung verwendet wird. Zeichenfolge (erforderlich)
cosmosDbContainer Der Name eines vorhandenen Containers in der Cosmos DB-Datenbank. Zeichenfolge (erforderlich)
cosmosDbDatabase Der Name einer vorhandenen Datenbank im Cosmos DB-Konto. Zeichenfolge (erforderlich)
managedIdentityResourceId Die Ressourcen-ID eines verwalteten Systems oder einer vom Benutzer zugewiesenen Identität. Die Identität wird verwendet, um sich bei Cosmos DB zu authentifizieren. Zeichenfolge (erforderlich)
mappingRuleName Der Name einer vorhandenen Zuordnungsregel, die beim Aufnehmen der abgerufenen Daten verwendet werden soll. Schnur
retrievalStartDate Wahlfrei. Wenn definiert, ruft die Datenverbindung Cosmos DB-Dokumente ab, die nach dem angegebenen Abrufanfangsdatum erstellt oder aktualisiert wurden. Schnur
tableName Der Name der vorhandenen Zieltabelle in Ihrem Cluster mit Beachtung der Groß-/Kleinschreibung. Abgerufene Daten werden in diese Tabelle aufgenommen. Zeichenfolge (erforderlich)

EventGridConnectionProperties

Name Beschreibung Wert
blobStorageEventType Der Name des zu verarbeitenden BLOB-Speicherereignistyps. "Microsoft.Storage.BlobCreated"
'Microsoft.Storage.BlobRenamed'
consumerGroup Die Event Hub-Consumergruppe. Zeichenfolge (erforderlich)
databaseRouting Angabe für Datenbankroutinginformationen aus der Datenverbindung, standardmäßig sind nur Datenbankroutinginformationen zulässig. "Multi"
"Single"
dataFormat Das Datenformat der Nachricht. Optional kann das Datenformat jeder Nachricht hinzugefügt werden. 'APACHEAVRO'
'AVRO'
"CSV"
"JSON"
'MULTIJSON'
"ORC"
"PARKETT"
'PSV'
"RAW"
'SCSV'
'SINGLEJSON'
'SOHSV'
"TSV"
"TSVE"
'TXT'
"W3CLOGFILE"
eventGridResourceId Die Ressourcen-ID des Ereignisrasters, das die Speicherkontoereignisse abonniert hat. Schnur
eventHubResourceId Die Ressourcen-ID, in der das Ereignisraster zum Senden von Ereignissen konfiguriert ist. Zeichenfolge (erforderlich)
ignoreFirstRecord Ein boolescher Wert, der bei Festlegung auf "true" angibt, dass die Aufnahme den ersten Datensatz jeder Datei ignorieren soll. Bool
managedIdentityResourceId Die Ressourcen-ID einer verwalteten Identität (System oder zugewiesener Benutzer), die für die Authentifizierung mit dem Event Hub- und Speicherkonto verwendet werden soll. Schnur
mappingRuleName Die Zuordnungsregel, die zum Aufnehmen der Daten verwendet werden soll. Optional können die Zuordnungsinformationen jeder Nachricht hinzugefügt werden. Schnur
storageAccountResourceId Die Ressourcen-ID des Speicherkontos, in dem sich die Daten befinden. Zeichenfolge (erforderlich)
tableName Die Tabelle, in der die Daten aufgenommen werden sollen. Optional können die Tabelleninformationen jeder Nachricht hinzugefügt werden. Schnur

EventGridDataConnection

Name Beschreibung Wert
Art Art des Endpunkts für die Datenverbindung 'EventGrid' (erforderlich)
Eigenschaften Die Eigenschaften der Ereignisraster-Datenverbindung. EventGridConnectionProperties-

EventHubConnectionProperties

Name Beschreibung Wert
Kompression Komprimierungstyp für Ereignishubnachrichten 'GZip'
'None'
consumerGroup Die Event Hub-Consumergruppe. Zeichenfolge (erforderlich)
databaseRouting Angabe für Datenbankroutinginformationen aus der Datenverbindung, standardmäßig sind nur Datenbankroutinginformationen zulässig. "Multi"
"Single"
dataFormat Das Datenformat der Nachricht. Optional kann das Datenformat jeder Nachricht hinzugefügt werden. 'APACHEAVRO'
'AVRO'
"CSV"
"JSON"
'MULTIJSON'
"ORC"
"PARKETT"
'PSV'
"RAW"
'SCSV'
'SINGLEJSON'
'SOHSV'
"TSV"
"TSVE"
'TXT'
"W3CLOGFILE"
eventHubResourceId Die Ressourcen-ID des Ereignishubs, die zum Erstellen einer Datenverbindung verwendet werden soll. Zeichenfolge (erforderlich)
eventSystemProperties Systemeigenschaften des Event Hubs string[]
managedIdentityResourceId Die Ressourcen-ID einer verwalteten Identität (system oder benutzer zugewiesen), die für die Authentifizierung mit dem Event Hub verwendet werden soll. Schnur
mappingRuleName Die Zuordnungsregel, die zum Aufnehmen der Daten verwendet werden soll. Optional können die Zuordnungsinformationen jeder Nachricht hinzugefügt werden. Schnur
retrievalStartDate Wenn definiert, ruft die Datenverbindung vorhandene Event Hub-Ereignisse ab, die seit dem Startdatum des Abrufs erstellt wurden. Sie kann nur Ereignisse abrufen, die vom Event Hub aufbewahrt werden, basierend auf dem Aufbewahrungszeitraum. Schnur
tableName Die Tabelle, in der die Daten aufgenommen werden sollen. Optional können die Tabelleninformationen jeder Nachricht hinzugefügt werden. Schnur

EventHubDataConnection

Name Beschreibung Wert
Art Art des Endpunkts für die Datenverbindung 'EventHub' (erforderlich)
Eigenschaften Die zu überprüfenden Event Hub-Datenverbindungseigenschaften. EventHubConnectionProperties-

IotHubConnectionProperties

Name Beschreibung Wert
consumerGroup Die Iot Hub-Consumergruppe. Zeichenfolge (erforderlich)
databaseRouting Angabe für Datenbankroutinginformationen aus der Datenverbindung, standardmäßig sind nur Datenbankroutinginformationen zulässig. "Multi"
"Single"
dataFormat Das Datenformat der Nachricht. Optional kann das Datenformat jeder Nachricht hinzugefügt werden. 'APACHEAVRO'
'AVRO'
"CSV"
"JSON"
'MULTIJSON'
"ORC"
"PARKETT"
'PSV'
"RAW"
'SCSV'
'SINGLEJSON'
'SOHSV'
"TSV"
"TSVE"
'TXT'
"W3CLOGFILE"
eventSystemProperties Systemeigenschaften des iot-Hubs string[]
iotHubResourceId Die Ressourcen-ID des Iot-Hubs, die zum Erstellen einer Datenverbindung verwendet werden soll. Zeichenfolge (erforderlich)
mappingRuleName Die Zuordnungsregel, die zum Aufnehmen der Daten verwendet werden soll. Optional können die Zuordnungsinformationen jeder Nachricht hinzugefügt werden. Schnur
retrievalStartDate Wenn definiert, ruft die Datenverbindung vorhandene Event Hub-Ereignisse ab, die seit dem Startdatum des Abrufs erstellt wurden. Sie kann nur Ereignisse abrufen, die vom Event Hub aufbewahrt werden, basierend auf dem Aufbewahrungszeitraum. Schnur
sharedAccessPolicyName Der Name der Freigabezugriffsrichtlinie Zeichenfolge (erforderlich)
tableName Die Tabelle, in der die Daten aufgenommen werden sollen. Optional können die Tabelleninformationen jeder Nachricht hinzugefügt werden. Schnur

IotHubDataConnection

Name Beschreibung Wert
Art Art des Endpunkts für die Datenverbindung "IotHub" (erforderlich)
Eigenschaften Die Iot Hub-Datenverbindungseigenschaften. IotHubConnectionProperties-

Microsoft.Kusto/clusters/databases/dataConnections

Name Beschreibung Wert
Art Wird für den Typ CosmosDbDataConnectionauf 'CosmosDbDbConnection' festgelegt. Set to 'EventGrid' for type EventGridDataConnection. Legen Sie für den Typ EventHubDataConnectionauf "EventHub" fest. Legen Sie für den Typ IotHubDataConnectionauf "IotHub" fest. 'CosmosDb'
'EventGrid'
'EventHub'
"IotHub" (erforderlich)
Ort Ressourcenspeicherort. Schnur
Name Der Ressourcenname Schnur

Zwänge:
Pattern = ^.*$ (erforderlich)
Elternteil In Bicep können Sie die übergeordnete Ressource für eine untergeordnete Ressource angeben. Sie müssen diese Eigenschaft nur hinzufügen, wenn die untergeordnete Ressource außerhalb der übergeordneten Ressource deklariert wird.

Weitere Informationen finden Sie unter Untergeordnete Ressource außerhalb der übergeordneten Ressource.
Symbolischer Name für Ressource vom Typ: Cluster/Datenbanken

Schnellstartbeispiele

Die folgenden Schnellstartbeispiele stellen diesen Ressourcentyp bereit.

Bicep-Datei Beschreibung
Bereitstellen von Azure Data Explorer DB mit Cosmos DB-Verbindung Bereitstellen von Azure Data Explorer DB mit Cosmos DB-Verbindung.
Bereitstellen von Azure Data Explorer db mit Ereignisrasterverbindung Bereitstellen von Azure Data Explorer db mit Event Grid-Verbindung.
Bereitstellen von Azure Data Explorer db mit Event Hub-Verbindung Bereitstellen von Azure Data Explorer db mit Event Hub-Verbindung.

ARM-Vorlagenressourcendefinition

Der Ressourcentyp cluster/databases/dataConnections kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.Kusto/clusters/databases/dataConnections-Ressource zu erstellen, fügen Sie Ihrer Vorlage den folgenden JSON-Code hinzu.

{
  "location": "string",
  "name": "string",
  "kind": "string"
  // For remaining properties, see Microsoft.Kusto/clusters/databases/dataConnections objects
}

Microsoft.Kusto/clusters/databases/dataConnections-Objekte

Legen Sie die Art Eigenschaft fest, um den Objekttyp anzugeben.

Verwenden Sie für CosmosDb:

{
  "kind": "CosmosDb",
  "properties": {
    "cosmosDbAccountResourceId": "string",
    "cosmosDbContainer": "string",
    "cosmosDbDatabase": "string",
    "managedIdentityResourceId": "string",
    "mappingRuleName": "string",
    "retrievalStartDate": "string",
    "tableName": "string"
  }
}

Verwenden Sie für EventGrid-:

{
  "kind": "EventGrid",
  "properties": {
    "blobStorageEventType": "string",
    "consumerGroup": "string",
    "databaseRouting": "string",
    "dataFormat": "string",
    "eventGridResourceId": "string",
    "eventHubResourceId": "string",
    "ignoreFirstRecord": "bool",
    "managedIdentityResourceId": "string",
    "mappingRuleName": "string",
    "storageAccountResourceId": "string",
    "tableName": "string"
  }
}

Verwenden Sie für EventHub-:

{
  "kind": "EventHub",
  "properties": {
    "compression": "string",
    "consumerGroup": "string",
    "databaseRouting": "string",
    "dataFormat": "string",
    "eventHubResourceId": "string",
    "eventSystemProperties": [ "string" ],
    "managedIdentityResourceId": "string",
    "mappingRuleName": "string",
    "retrievalStartDate": "string",
    "tableName": "string"
  }
}

Verwenden Sie für IotHub-:

{
  "kind": "IotHub",
  "properties": {
    "consumerGroup": "string",
    "databaseRouting": "string",
    "dataFormat": "string",
    "eventSystemProperties": [ "string" ],
    "iotHubResourceId": "string",
    "mappingRuleName": "string",
    "retrievalStartDate": "string",
    "sharedAccessPolicyName": "string",
    "tableName": "string"
  }
}

Eigenschaftswerte

CosmosDbDataConnection

Name Beschreibung Wert
Art Art des Endpunkts für die Datenverbindung 'CosmosDb' (erforderlich)
Eigenschaften Die Eigenschaften der CosmosDb-Datenverbindung. CosmosDbDataConnectionProperties

CosmosDbDataConnectionProperties

Name Beschreibung Wert
cosmosDbAccountResourceId Die Ressourcen-ID des Cosmos DB-Kontos, das zum Erstellen der Datenverbindung verwendet wird. Zeichenfolge (erforderlich)
cosmosDbContainer Der Name eines vorhandenen Containers in der Cosmos DB-Datenbank. Zeichenfolge (erforderlich)
cosmosDbDatabase Der Name einer vorhandenen Datenbank im Cosmos DB-Konto. Zeichenfolge (erforderlich)
managedIdentityResourceId Die Ressourcen-ID eines verwalteten Systems oder einer vom Benutzer zugewiesenen Identität. Die Identität wird verwendet, um sich bei Cosmos DB zu authentifizieren. Zeichenfolge (erforderlich)
mappingRuleName Der Name einer vorhandenen Zuordnungsregel, die beim Aufnehmen der abgerufenen Daten verwendet werden soll. Schnur
retrievalStartDate Wahlfrei. Wenn definiert, ruft die Datenverbindung Cosmos DB-Dokumente ab, die nach dem angegebenen Abrufanfangsdatum erstellt oder aktualisiert wurden. Schnur
tableName Der Name der vorhandenen Zieltabelle in Ihrem Cluster mit Beachtung der Groß-/Kleinschreibung. Abgerufene Daten werden in diese Tabelle aufgenommen. Zeichenfolge (erforderlich)

EventGridConnectionProperties

Name Beschreibung Wert
blobStorageEventType Der Name des zu verarbeitenden BLOB-Speicherereignistyps. "Microsoft.Storage.BlobCreated"
'Microsoft.Storage.BlobRenamed'
consumerGroup Die Event Hub-Consumergruppe. Zeichenfolge (erforderlich)
databaseRouting Angabe für Datenbankroutinginformationen aus der Datenverbindung, standardmäßig sind nur Datenbankroutinginformationen zulässig. "Multi"
"Single"
dataFormat Das Datenformat der Nachricht. Optional kann das Datenformat jeder Nachricht hinzugefügt werden. 'APACHEAVRO'
'AVRO'
"CSV"
"JSON"
'MULTIJSON'
"ORC"
"PARKETT"
'PSV'
"RAW"
'SCSV'
'SINGLEJSON'
'SOHSV'
"TSV"
"TSVE"
'TXT'
"W3CLOGFILE"
eventGridResourceId Die Ressourcen-ID des Ereignisrasters, das die Speicherkontoereignisse abonniert hat. Schnur
eventHubResourceId Die Ressourcen-ID, in der das Ereignisraster zum Senden von Ereignissen konfiguriert ist. Zeichenfolge (erforderlich)
ignoreFirstRecord Ein boolescher Wert, der bei Festlegung auf "true" angibt, dass die Aufnahme den ersten Datensatz jeder Datei ignorieren soll. Bool
managedIdentityResourceId Die Ressourcen-ID einer verwalteten Identität (System oder zugewiesener Benutzer), die für die Authentifizierung mit dem Event Hub- und Speicherkonto verwendet werden soll. Schnur
mappingRuleName Die Zuordnungsregel, die zum Aufnehmen der Daten verwendet werden soll. Optional können die Zuordnungsinformationen jeder Nachricht hinzugefügt werden. Schnur
storageAccountResourceId Die Ressourcen-ID des Speicherkontos, in dem sich die Daten befinden. Zeichenfolge (erforderlich)
tableName Die Tabelle, in der die Daten aufgenommen werden sollen. Optional können die Tabelleninformationen jeder Nachricht hinzugefügt werden. Schnur

EventGridDataConnection

Name Beschreibung Wert
Art Art des Endpunkts für die Datenverbindung 'EventGrid' (erforderlich)
Eigenschaften Die Eigenschaften der Ereignisraster-Datenverbindung. EventGridConnectionProperties-

EventHubConnectionProperties

Name Beschreibung Wert
Kompression Komprimierungstyp für Ereignishubnachrichten 'GZip'
'None'
consumerGroup Die Event Hub-Consumergruppe. Zeichenfolge (erforderlich)
databaseRouting Angabe für Datenbankroutinginformationen aus der Datenverbindung, standardmäßig sind nur Datenbankroutinginformationen zulässig. "Multi"
"Single"
dataFormat Das Datenformat der Nachricht. Optional kann das Datenformat jeder Nachricht hinzugefügt werden. 'APACHEAVRO'
'AVRO'
"CSV"
"JSON"
'MULTIJSON'
"ORC"
"PARKETT"
'PSV'
"RAW"
'SCSV'
'SINGLEJSON'
'SOHSV'
"TSV"
"TSVE"
'TXT'
"W3CLOGFILE"
eventHubResourceId Die Ressourcen-ID des Ereignishubs, die zum Erstellen einer Datenverbindung verwendet werden soll. Zeichenfolge (erforderlich)
eventSystemProperties Systemeigenschaften des Event Hubs string[]
managedIdentityResourceId Die Ressourcen-ID einer verwalteten Identität (system oder benutzer zugewiesen), die für die Authentifizierung mit dem Event Hub verwendet werden soll. Schnur
mappingRuleName Die Zuordnungsregel, die zum Aufnehmen der Daten verwendet werden soll. Optional können die Zuordnungsinformationen jeder Nachricht hinzugefügt werden. Schnur
retrievalStartDate Wenn definiert, ruft die Datenverbindung vorhandene Event Hub-Ereignisse ab, die seit dem Startdatum des Abrufs erstellt wurden. Sie kann nur Ereignisse abrufen, die vom Event Hub aufbewahrt werden, basierend auf dem Aufbewahrungszeitraum. Schnur
tableName Die Tabelle, in der die Daten aufgenommen werden sollen. Optional können die Tabelleninformationen jeder Nachricht hinzugefügt werden. Schnur

EventHubDataConnection

Name Beschreibung Wert
Art Art des Endpunkts für die Datenverbindung 'EventHub' (erforderlich)
Eigenschaften Die zu überprüfenden Event Hub-Datenverbindungseigenschaften. EventHubConnectionProperties-

IotHubConnectionProperties

Name Beschreibung Wert
consumerGroup Die Iot Hub-Consumergruppe. Zeichenfolge (erforderlich)
databaseRouting Angabe für Datenbankroutinginformationen aus der Datenverbindung, standardmäßig sind nur Datenbankroutinginformationen zulässig. "Multi"
"Single"
dataFormat Das Datenformat der Nachricht. Optional kann das Datenformat jeder Nachricht hinzugefügt werden. 'APACHEAVRO'
'AVRO'
"CSV"
"JSON"
'MULTIJSON'
"ORC"
"PARKETT"
'PSV'
"RAW"
'SCSV'
'SINGLEJSON'
'SOHSV'
"TSV"
"TSVE"
'TXT'
"W3CLOGFILE"
eventSystemProperties Systemeigenschaften des iot-Hubs string[]
iotHubResourceId Die Ressourcen-ID des Iot-Hubs, die zum Erstellen einer Datenverbindung verwendet werden soll. Zeichenfolge (erforderlich)
mappingRuleName Die Zuordnungsregel, die zum Aufnehmen der Daten verwendet werden soll. Optional können die Zuordnungsinformationen jeder Nachricht hinzugefügt werden. Schnur
retrievalStartDate Wenn definiert, ruft die Datenverbindung vorhandene Event Hub-Ereignisse ab, die seit dem Startdatum des Abrufs erstellt wurden. Sie kann nur Ereignisse abrufen, die vom Event Hub aufbewahrt werden, basierend auf dem Aufbewahrungszeitraum. Schnur
sharedAccessPolicyName Der Name der Freigabezugriffsrichtlinie Zeichenfolge (erforderlich)
tableName Die Tabelle, in der die Daten aufgenommen werden sollen. Optional können die Tabelleninformationen jeder Nachricht hinzugefügt werden. Schnur

IotHubDataConnection

Name Beschreibung Wert
Art Art des Endpunkts für die Datenverbindung "IotHub" (erforderlich)
Eigenschaften Die Iot Hub-Datenverbindungseigenschaften. IotHubConnectionProperties-

Microsoft.Kusto/clusters/databases/dataConnections

Name Beschreibung Wert
apiVersion Die API-Version '2024-04-13'
Art Wird für den Typ CosmosDbDataConnectionauf 'CosmosDbDbConnection' festgelegt. Set to 'EventGrid' for type EventGridDataConnection. Legen Sie für den Typ EventHubDataConnectionauf "EventHub" fest. Legen Sie für den Typ IotHubDataConnectionauf "IotHub" fest. 'CosmosDb'
'EventGrid'
'EventHub'
"IotHub" (erforderlich)
Ort Ressourcenspeicherort. Schnur
Name Der Ressourcenname Schnur

Zwänge:
Pattern = ^.*$ (erforderlich)
Art Der Ressourcentyp "Microsoft.Kusto/clusters/databases/dataConnections"

Schnellstartvorlagen

Die folgenden Schnellstartvorlagen stellen diesen Ressourcentyp bereit.

Schablone Beschreibung
Bereitstellen von Azure Data Explorer DB mit Cosmos DB-Verbindung

Bereitstellen in Azure
Bereitstellen von Azure Data Explorer DB mit Cosmos DB-Verbindung.
Bereitstellen von Azure Data Explorer db mit Ereignisrasterverbindung

Bereitstellen in Azure
Bereitstellen von Azure Data Explorer db mit Event Grid-Verbindung.
Bereitstellen von Azure Data Explorer db mit Event Hub-Verbindung

Bereitstellen in Azure
Bereitstellen von Azure Data Explorer db mit Event Hub-Verbindung.

Terraform -Ressourcendefinition (AzAPI-Anbieter)

Der Ressourcentyp cluster/databases/dataConnections kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

  • Ressourcengruppen

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.Kusto/clusters/databases/dataConnections-Ressource zu erstellen, fügen Sie Ihrer Vorlage die folgende Terraform hinzu.

resource "azapi_resource" "symbolicname" {
  location = "string"
  name = "string"
  kind = "string"
  // For remaining properties, see Microsoft.Kusto/clusters/databases/dataConnections objects
}

Microsoft.Kusto/clusters/databases/dataConnections-Objekte

Legen Sie die Art Eigenschaft fest, um den Objekttyp anzugeben.

Verwenden Sie für CosmosDb:

{
  kind = "CosmosDb"
  properties = {
    cosmosDbAccountResourceId = "string"
    cosmosDbContainer = "string"
    cosmosDbDatabase = "string"
    managedIdentityResourceId = "string"
    mappingRuleName = "string"
    retrievalStartDate = "string"
    tableName = "string"
  }
}

Verwenden Sie für EventGrid-:

{
  kind = "EventGrid"
  properties = {
    blobStorageEventType = "string"
    consumerGroup = "string"
    databaseRouting = "string"
    dataFormat = "string"
    eventGridResourceId = "string"
    eventHubResourceId = "string"
    ignoreFirstRecord = bool
    managedIdentityResourceId = "string"
    mappingRuleName = "string"
    storageAccountResourceId = "string"
    tableName = "string"
  }
}

Verwenden Sie für EventHub-:

{
  kind = "EventHub"
  properties = {
    compression = "string"
    consumerGroup = "string"
    databaseRouting = "string"
    dataFormat = "string"
    eventHubResourceId = "string"
    eventSystemProperties = [
      "string"
    ]
    managedIdentityResourceId = "string"
    mappingRuleName = "string"
    retrievalStartDate = "string"
    tableName = "string"
  }
}

Verwenden Sie für IotHub-:

{
  kind = "IotHub"
  properties = {
    consumerGroup = "string"
    databaseRouting = "string"
    dataFormat = "string"
    eventSystemProperties = [
      "string"
    ]
    iotHubResourceId = "string"
    mappingRuleName = "string"
    retrievalStartDate = "string"
    sharedAccessPolicyName = "string"
    tableName = "string"
  }
}

Eigenschaftswerte

CosmosDbDataConnection

Name Beschreibung Wert
Art Art des Endpunkts für die Datenverbindung 'CosmosDb' (erforderlich)
Eigenschaften Die Eigenschaften der CosmosDb-Datenverbindung. CosmosDbDataConnectionProperties

CosmosDbDataConnectionProperties

Name Beschreibung Wert
cosmosDbAccountResourceId Die Ressourcen-ID des Cosmos DB-Kontos, das zum Erstellen der Datenverbindung verwendet wird. Zeichenfolge (erforderlich)
cosmosDbContainer Der Name eines vorhandenen Containers in der Cosmos DB-Datenbank. Zeichenfolge (erforderlich)
cosmosDbDatabase Der Name einer vorhandenen Datenbank im Cosmos DB-Konto. Zeichenfolge (erforderlich)
managedIdentityResourceId Die Ressourcen-ID eines verwalteten Systems oder einer vom Benutzer zugewiesenen Identität. Die Identität wird verwendet, um sich bei Cosmos DB zu authentifizieren. Zeichenfolge (erforderlich)
mappingRuleName Der Name einer vorhandenen Zuordnungsregel, die beim Aufnehmen der abgerufenen Daten verwendet werden soll. Schnur
retrievalStartDate Wahlfrei. Wenn definiert, ruft die Datenverbindung Cosmos DB-Dokumente ab, die nach dem angegebenen Abrufanfangsdatum erstellt oder aktualisiert wurden. Schnur
tableName Der Name der vorhandenen Zieltabelle in Ihrem Cluster mit Beachtung der Groß-/Kleinschreibung. Abgerufene Daten werden in diese Tabelle aufgenommen. Zeichenfolge (erforderlich)

EventGridConnectionProperties

Name Beschreibung Wert
blobStorageEventType Der Name des zu verarbeitenden BLOB-Speicherereignistyps. "Microsoft.Storage.BlobCreated"
'Microsoft.Storage.BlobRenamed'
consumerGroup Die Event Hub-Consumergruppe. Zeichenfolge (erforderlich)
databaseRouting Angabe für Datenbankroutinginformationen aus der Datenverbindung, standardmäßig sind nur Datenbankroutinginformationen zulässig. "Multi"
"Single"
dataFormat Das Datenformat der Nachricht. Optional kann das Datenformat jeder Nachricht hinzugefügt werden. 'APACHEAVRO'
'AVRO'
"CSV"
"JSON"
'MULTIJSON'
"ORC"
"PARKETT"
'PSV'
"RAW"
'SCSV'
'SINGLEJSON'
'SOHSV'
"TSV"
"TSVE"
'TXT'
"W3CLOGFILE"
eventGridResourceId Die Ressourcen-ID des Ereignisrasters, das die Speicherkontoereignisse abonniert hat. Schnur
eventHubResourceId Die Ressourcen-ID, in der das Ereignisraster zum Senden von Ereignissen konfiguriert ist. Zeichenfolge (erforderlich)
ignoreFirstRecord Ein boolescher Wert, der bei Festlegung auf "true" angibt, dass die Aufnahme den ersten Datensatz jeder Datei ignorieren soll. Bool
managedIdentityResourceId Die Ressourcen-ID einer verwalteten Identität (System oder zugewiesener Benutzer), die für die Authentifizierung mit dem Event Hub- und Speicherkonto verwendet werden soll. Schnur
mappingRuleName Die Zuordnungsregel, die zum Aufnehmen der Daten verwendet werden soll. Optional können die Zuordnungsinformationen jeder Nachricht hinzugefügt werden. Schnur
storageAccountResourceId Die Ressourcen-ID des Speicherkontos, in dem sich die Daten befinden. Zeichenfolge (erforderlich)
tableName Die Tabelle, in der die Daten aufgenommen werden sollen. Optional können die Tabelleninformationen jeder Nachricht hinzugefügt werden. Schnur

EventGridDataConnection

Name Beschreibung Wert
Art Art des Endpunkts für die Datenverbindung 'EventGrid' (erforderlich)
Eigenschaften Die Eigenschaften der Ereignisraster-Datenverbindung. EventGridConnectionProperties-

EventHubConnectionProperties

Name Beschreibung Wert
Kompression Komprimierungstyp für Ereignishubnachrichten 'GZip'
'None'
consumerGroup Die Event Hub-Consumergruppe. Zeichenfolge (erforderlich)
databaseRouting Angabe für Datenbankroutinginformationen aus der Datenverbindung, standardmäßig sind nur Datenbankroutinginformationen zulässig. "Multi"
"Single"
dataFormat Das Datenformat der Nachricht. Optional kann das Datenformat jeder Nachricht hinzugefügt werden. 'APACHEAVRO'
'AVRO'
"CSV"
"JSON"
'MULTIJSON'
"ORC"
"PARKETT"
'PSV'
"RAW"
'SCSV'
'SINGLEJSON'
'SOHSV'
"TSV"
"TSVE"
'TXT'
"W3CLOGFILE"
eventHubResourceId Die Ressourcen-ID des Ereignishubs, die zum Erstellen einer Datenverbindung verwendet werden soll. Zeichenfolge (erforderlich)
eventSystemProperties Systemeigenschaften des Event Hubs string[]
managedIdentityResourceId Die Ressourcen-ID einer verwalteten Identität (system oder benutzer zugewiesen), die für die Authentifizierung mit dem Event Hub verwendet werden soll. Schnur
mappingRuleName Die Zuordnungsregel, die zum Aufnehmen der Daten verwendet werden soll. Optional können die Zuordnungsinformationen jeder Nachricht hinzugefügt werden. Schnur
retrievalStartDate Wenn definiert, ruft die Datenverbindung vorhandene Event Hub-Ereignisse ab, die seit dem Startdatum des Abrufs erstellt wurden. Sie kann nur Ereignisse abrufen, die vom Event Hub aufbewahrt werden, basierend auf dem Aufbewahrungszeitraum. Schnur
tableName Die Tabelle, in der die Daten aufgenommen werden sollen. Optional können die Tabelleninformationen jeder Nachricht hinzugefügt werden. Schnur

EventHubDataConnection

Name Beschreibung Wert
Art Art des Endpunkts für die Datenverbindung 'EventHub' (erforderlich)
Eigenschaften Die zu überprüfenden Event Hub-Datenverbindungseigenschaften. EventHubConnectionProperties-

IotHubConnectionProperties

Name Beschreibung Wert
consumerGroup Die Iot Hub-Consumergruppe. Zeichenfolge (erforderlich)
databaseRouting Angabe für Datenbankroutinginformationen aus der Datenverbindung, standardmäßig sind nur Datenbankroutinginformationen zulässig. "Multi"
"Single"
dataFormat Das Datenformat der Nachricht. Optional kann das Datenformat jeder Nachricht hinzugefügt werden. 'APACHEAVRO'
'AVRO'
"CSV"
"JSON"
'MULTIJSON'
"ORC"
"PARKETT"
'PSV'
"RAW"
'SCSV'
'SINGLEJSON'
'SOHSV'
"TSV"
"TSVE"
'TXT'
"W3CLOGFILE"
eventSystemProperties Systemeigenschaften des iot-Hubs string[]
iotHubResourceId Die Ressourcen-ID des Iot-Hubs, die zum Erstellen einer Datenverbindung verwendet werden soll. Zeichenfolge (erforderlich)
mappingRuleName Die Zuordnungsregel, die zum Aufnehmen der Daten verwendet werden soll. Optional können die Zuordnungsinformationen jeder Nachricht hinzugefügt werden. Schnur
retrievalStartDate Wenn definiert, ruft die Datenverbindung vorhandene Event Hub-Ereignisse ab, die seit dem Startdatum des Abrufs erstellt wurden. Sie kann nur Ereignisse abrufen, die vom Event Hub aufbewahrt werden, basierend auf dem Aufbewahrungszeitraum. Schnur
sharedAccessPolicyName Der Name der Freigabezugriffsrichtlinie Zeichenfolge (erforderlich)
tableName Die Tabelle, in der die Daten aufgenommen werden sollen. Optional können die Tabelleninformationen jeder Nachricht hinzugefügt werden. Schnur

IotHubDataConnection

Name Beschreibung Wert
Art Art des Endpunkts für die Datenverbindung "IotHub" (erforderlich)
Eigenschaften Die Iot Hub-Datenverbindungseigenschaften. IotHubConnectionProperties-

Microsoft.Kusto/clusters/databases/dataConnections

Name Beschreibung Wert
Art Wird für den Typ CosmosDbDataConnectionauf 'CosmosDbDbConnection' festgelegt. Set to 'EventGrid' for type EventGridDataConnection. Legen Sie für den Typ EventHubDataConnectionauf "EventHub" fest. Legen Sie für den Typ IotHubDataConnectionauf "IotHub" fest. 'CosmosDb'
'EventGrid'
'EventHub'
"IotHub" (erforderlich)
Ort Ressourcenspeicherort. Schnur
Name Der Ressourcenname Schnur

Zwänge:
Pattern = ^.*$ (erforderlich)
parent_id Die ID der Ressource, die das übergeordnete Element für diese Ressource ist. ID für Ressource vom Typ: Cluster/Datenbanken
Art Der Ressourcentyp "Microsoft.Kusto/clusters/databases/dataConnections@2024-04-13"