Share via

Microsoft.Kusto clusters/databases/dataConnections 2022-11-11

  • Artikel

Bicep-Ressourcendefinition

Der Ressourcentyp clusters/databases/dataConnections kann mit Vorgängen bereitgestellt werden, die Folgendes zum Ziel haben:

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 den folgenden Bicep hinzu.

resource symbolicname 'Microsoft.Kusto/clusters/databases/dataConnections@2022-11-11' = {
  name: 'string'
  location: 'string'
  kind: 'string'
  parent: resourceSymbolicName
  // For remaining properties, see clusters/databases/dataConnections objects
}

cluster/databases/dataConnections-Objekte

Legen Sie die kind-Eigenschaft fest, um den Typ des Objekts anzugeben.

Verwenden Sie für CosmosDb Folgendes:

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

Verwenden Sie für EventGrid Folgendes:

  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 Folgendes:

  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 Folgendes:

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

Eigenschaftswerte

cluster/databases/dataConnections

Name BESCHREIBUNG Wert
name Der Ressourcenname

Erfahren Sie, wie Sie Namen und Typen für untergeordnete Ressourcen in Bicep festlegen.		 Zeichenfolge (erforderlich)
location Ressourcenspeicherort Zeichenfolge
kind Festlegen des Objekttyps CosmosDb
EventGrid
EventHub
IotHub (erforderlich)
parent 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: Datenbanken

CosmosDbDataConnection

Name BESCHREIBUNG Wert
kind Art des Endpunkts für die Datenverbindung "CosmosDb" (erforderlich)
properties 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 benutzerseitig 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 Erfassen der abgerufenen Daten verwendet werden soll. Zeichenfolge
retrievalStartDate Optional. Sofern definiert, ruft die Datenverbindung Cosmos DB-Dokumente ab, die nach dem angegebenen Abrufstartdatum erstellt oder aktualisiert wurden. Zeichenfolge
tableName Der Name der vorhandenen Zieltabelle in Ihrem Cluster, bei dem die Groß-/Kleinschreibung beachtet wird. Die abgerufenen Daten werden in dieser Tabelle erfasst. Zeichenfolge (erforderlich)

EventGridDataConnection

Name BESCHREIBUNG Wert
kind Art des Endpunkts für die Datenverbindung 'EventGrid' (erforderlich)
properties Die Eigenschaften der Event Grid-Datenverbindung. EventGridConnectionProperties

EventGridConnectionProperties

Name BESCHREIBUNG Wert
blobStorageEventType Der Name des zu verarbeitenden Blob Storage-Ereignistyps. "Microsoft.Storage.BlobCreated"
"Microsoft.Storage.BlobRenamed"
consumerGroup Die Event Hub-Consumergruppe. Zeichenfolge (erforderlich)
databaseRouting Anzeige für Datenbankroutinginformationen aus der Datenverbindung. Standardmäßig sind nur Datenbankroutinginformationen zulässig. "Multi"
"Single"
dataFormat Das Datenformat der Nachricht. Optional kann jeder Nachricht das Datenformat hinzugefügt werden. "APACHEAVRO"
"AVRO"
"CSV"
"JSON"
"MULTIJSON"
"ORC"
"PARQUET"
"PSV"
"RAW"
"SCSV"
"SINGLEJSON"
"SOHSV"
"TSV"
"TSVE"
"TXT"
"W3CLOGFILE"
eventGridResourceId Die Ressourcen-ID des Event Grids, das die Speicherkontoereignisse abonniert ist. Zeichenfolge
eventHubResourceId Die Ressourcen-ID, in der das Event Grid zum Senden von Ereignissen konfiguriert ist. Zeichenfolge (erforderlich)
ignoreFirstRecord Ein boolescher Wert, der bei Festlegung auf TRUE angibt, dass die Erfassung den ersten Datensatz jeder Datei ignorieren sollte. bool
managedIdentityResourceId Die Ressourcen-ID einer verwalteten Identität (system- oder benutzerseitig zugewiesen), die für die Authentifizierung beim Event Hub und speicherkonto verwendet werden soll. Zeichenfolge
mappingRuleName Die Zuordnungsregel, die zum Erfassen der Daten verwendet werden soll. Optional können die Zuordnungsinformationen zu jeder Nachricht hinzugefügt werden. Zeichenfolge
storageAccountResourceId Die Ressourcen-ID des Speicherkontos, in dem sich die Daten befinden. Zeichenfolge (erforderlich)
tableName Die Tabelle, in der die Daten erfasst werden sollen. Optional können die Tabelleninformationen zu jeder Nachricht hinzugefügt werden. Zeichenfolge

EventHubDataConnection

Name BESCHREIBUNG Wert
kind Art des Endpunkts für die Datenverbindung "EventHub" (erforderlich)
properties Die zu überprüfenden Event Hub-Datenverbindungseigenschaften. EventHubConnectionProperties

EventHubConnectionProperties

Name BESCHREIBUNG Wert
compression Der Event Hub-Nachrichtenkomprimierungstyp "GZip"
"Keine"
consumerGroup Die Event Hub-Consumergruppe. Zeichenfolge (erforderlich)
databaseRouting Anzeige für Datenbankroutinginformationen aus der Datenverbindung. Standardmäßig sind nur Datenbankroutinginformationen zulässig. "Multi"
"Single"
dataFormat Das Datenformat der Nachricht. Optional kann jeder Nachricht das Datenformat hinzugefügt werden. "APACHEAVRO"
"AVRO"
"CSV"
"JSON"
"MULTIJSON"
"ORC"
"PARQUET"
"PSV"
"RAW"
"SCSV"
"SINGLEJSON"
"SOHSV"
"TSV"
"TSVE"
"TXT"
"W3CLOGFILE"
eventHubResourceId Die Ressourcen-ID des Event Hubs, der 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 benutzerseitig zugewiesen), die für die Authentifizierung beim Event Hub verwendet werden soll. Zeichenfolge
mappingRuleName Die Zuordnungsregel, die zum Erfassen der Daten verwendet werden soll. Optional können die Zuordnungsinformationen zu jeder Nachricht hinzugefügt werden. Zeichenfolge
retrievalStartDate Wenn sie definiert ist, ruft die Datenverbindung vorhandene Event Hub-Ereignisse ab, die seit dem Startdatum des Abrufs erstellt wurden. Es kann nur Ereignisse abrufen, die vom Event Hub aufbewahrt werden, basierend auf seinem Aufbewahrungszeitraum. Zeichenfolge
tableName Die Tabelle, in der die Daten erfasst werden sollen. Optional können die Tabelleninformationen zu jeder Nachricht hinzugefügt werden. Zeichenfolge

IotHubDataConnection

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

IotHubConnectionProperties

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

Schnellstartvorlagen

In den folgenden Schnellstartvorlagen wird dieser Ressourcentyp bereitgestellt.

Vorlage 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 Event Hub-Verbindung

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

Ressourcendefinition mit einer ARM-Vorlage

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

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

Ressourcenformat

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

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

cluster/databases/dataConnections-Objekte

Legen Sie die kind-Eigenschaft fest, um den Typ des Objekts anzugeben.

Verwenden Sie für CosmosDb Folgendes:

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

Verwenden Sie für EventGrid Folgendes:

  "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 Folgendes:

  "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 Folgendes:

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

Eigenschaftswerte

clusters/databases/dataConnections

Name BESCHREIBUNG Wert
type Der Ressourcentyp "Microsoft.Kusto/clusters/databases/dataConnections"
apiVersion Die Version der Ressourcen-API '2022-11-11'
name Der Ressourcenname

Weitere Informationen finden Sie unter Festlegen von Namen und Typen für untergeordnete Ressourcen in JSON-ARM-Vorlagen.		 Zeichenfolge (erforderlich)
location Ressourcenspeicherort Zeichenfolge
kind Festlegen des Objekttyps CosmosDb
EventGrid
EventHub
IotHub (erforderlich)

CosmosDbDataConnection

Name BESCHREIBUNG Wert
kind Art des Endpunkts für die Datenverbindung "CosmosDb" (erforderlich)
properties 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 benutzerseitig zugewiesenen Identität. Die Identität wird für die Authentifizierung bei Cosmos DB verwendet. Zeichenfolge (erforderlich)
mappingRuleName Der Name einer vorhandenen Zuordnungsregel, die beim Erfassen der abgerufenen Daten verwendet werden soll. Zeichenfolge
retrievalStartDate Optional. Falls definiert, ruft die Datenverbindung Cosmos DB-Dokumente ab, die nach dem angegebenen Startdatum des Abrufs erstellt oder aktualisiert wurden. Zeichenfolge
tableName Der Name der vorhandenen Zieltabelle in Ihrem Cluster, bei dem die Groß-/Kleinschreibung beachtet wird. Die abgerufenen Daten werden in dieser Tabelle erfasst. Zeichenfolge (erforderlich)

EventGridDataConnection

Name BESCHREIBUNG Wert
kind Art des Endpunkts für die Datenverbindung 'EventGrid' (erforderlich)
properties Die Eigenschaften der Event Grid-Datenverbindung. EventGridConnectionProperties

EventGridConnectionProperties

Name BESCHREIBUNG Wert
blobStorageEventType Der Name des zu verarbeitenden Blob Storage-Ereignistyps. "Microsoft.Storage.BlobCreated"
"Microsoft.Storage.BlobRenamed"
consumerGroup Die Event Hub-Consumergruppe. Zeichenfolge (erforderlich)
databaseRouting Anzeige für Datenbankroutinginformationen aus der Datenverbindung. Standardmäßig sind nur Datenbankroutinginformationen zulässig. "Multi"
"Single"
dataFormat Das Datenformat der Nachricht. Optional kann jeder Nachricht das Datenformat hinzugefügt werden. "APACHEAVRO"
"AVRO"
"CSV"
"JSON"
"MULTIJSON"
"ORC"
"PARQUET"
"PSV"
"RAW"
"SCSV"
"SINGLEJSON"
"SOHSV"
"TSV"
"TSVE"
"TXT"
"W3CLOGFILE"
eventGridResourceId Die Ressourcen-ID des Event Grids, das die Speicherkontoereignisse abonniert ist. Zeichenfolge
eventHubResourceId Die Ressourcen-ID, in der das Event Grid zum Senden von Ereignissen konfiguriert ist. Zeichenfolge (erforderlich)
ignoreFirstRecord Ein boolescher Wert, der bei Festlegung auf TRUE angibt, dass die Erfassung den ersten Datensatz jeder Datei ignorieren sollte. bool
managedIdentityResourceId Die Ressourcen-ID einer verwalteten Identität (system- oder benutzerseitig zugewiesen), die für die Authentifizierung beim Event Hub und speicherkonto verwendet werden soll. Zeichenfolge
mappingRuleName Die Zuordnungsregel, die zum Erfassen der Daten verwendet werden soll. Optional können die Zuordnungsinformationen zu jeder Nachricht hinzugefügt werden. Zeichenfolge
storageAccountResourceId Die Ressourcen-ID des Speicherkontos, in dem sich die Daten befinden. Zeichenfolge (erforderlich)
tableName Die Tabelle, in der die Daten erfasst werden sollen. Optional können die Tabelleninformationen zu jeder Nachricht hinzugefügt werden. Zeichenfolge

EventHubDataConnection

Name BESCHREIBUNG Wert
kind Art des Endpunkts für die Datenverbindung "EventHub" (erforderlich)
properties Die zu überprüfenden Event Hub-Datenverbindungseigenschaften. EventHubConnectionProperties

EventHubConnectionProperties

Name BESCHREIBUNG Wert
compression Der Event Hub-Nachrichtenkomprimierungstyp "GZip"
"Keine"
consumerGroup Die Event Hub-Consumergruppe. Zeichenfolge (erforderlich)
databaseRouting Anzeige für Datenbankroutinginformationen aus der Datenverbindung. Standardmäßig sind nur Datenbankroutinginformationen zulässig. "Multi"
"Single"
dataFormat Das Datenformat der Nachricht. Optional kann jeder Nachricht das Datenformat hinzugefügt werden. "APACHEAVRO"
"AVRO"
"CSV"
"JSON"
"MULTIJSON"
"ORC"
"PARQUET"
"PSV"
"RAW"
"SCSV"
"SINGLEJSON"
"SOHSV"
"TSV"
"TSVE"
"TXT"
"W3CLOGFILE"
eventHubResourceId Die Ressourcen-ID des Event Hubs, der 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 benutzerseitig zugewiesen), die für die Authentifizierung beim Event Hub verwendet werden soll. Zeichenfolge
mappingRuleName Die Zuordnungsregel, die zum Erfassen der Daten verwendet werden soll. Optional können die Zuordnungsinformationen zu jeder Nachricht hinzugefügt werden. Zeichenfolge
retrievalStartDate Wenn sie definiert ist, ruft die Datenverbindung vorhandene Event Hub-Ereignisse ab, die seit dem Startdatum des Abrufs erstellt wurden. Es kann nur Ereignisse abrufen, die vom Event Hub aufbewahrt werden, basierend auf seinem Aufbewahrungszeitraum. Zeichenfolge
tableName Die Tabelle, in der die Daten erfasst werden sollen. Optional können die Tabelleninformationen zu jeder Nachricht hinzugefügt werden. Zeichenfolge

IotHubDataConnection

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

IotHubConnectionProperties

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

Schnellstartvorlagen

In den folgenden Schnellstartvorlagen wird dieser Ressourcentyp bereitgestellt.

Vorlage 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 Event Hub-Verbindung

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

Terraform-Ressourcendefinition (AzAPI-Anbieter)

Der Ressourcentyp clusters/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 im Änderungsprotokoll.

Ressourcenformat

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Kusto/clusters/databases/dataConnections@2022-11-11"
  name = "string"
  location = "string"
  parent_id = "string"
  // For remaining properties, see clusters/databases/dataConnections objects
  body = jsonencode({
    kind = "string"
  })
}

cluster/databases/dataConnections-Objekte

Legen Sie die kind-Eigenschaft fest, um den Typ des Objekts anzugeben.

Verwenden Sie für CosmosDb Folgendes:

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

Verwenden Sie für EventGrid Folgendes:

  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 Folgendes:

  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 Folgendes:

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

Eigenschaftswerte

clusters/databases/dataConnections

Name BESCHREIBUNG Wert
type Der Ressourcentyp "Microsoft.Kusto/clusters/databases/dataConnections@2022-11-11"
name Der Ressourcenname Zeichenfolge (erforderlich)
location Ressourcenspeicherort Zeichenfolge
parent_id Die ID der Ressource, die das übergeordnete Element für diese Ressource ist. ID für Ressource vom Typ: Datenbanken
kind Festlegen des Objekttyps CosmosDb
EventGrid
EventHub
IotHub (erforderlich)

CosmosDbDataConnection

Name BESCHREIBUNG Wert
kind Art des Endpunkts für die Datenverbindung "CosmosDb" (erforderlich)
properties 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 benutzerseitig zugewiesenen Identität. Die Identität wird für die Authentifizierung bei Cosmos DB verwendet. Zeichenfolge (erforderlich)
mappingRuleName Der Name einer vorhandenen Zuordnungsregel, die beim Erfassen der abgerufenen Daten verwendet werden soll. Zeichenfolge
retrievalStartDate Optional. Falls definiert, ruft die Datenverbindung Cosmos DB-Dokumente ab, die nach dem angegebenen Startdatum des Abrufs erstellt oder aktualisiert wurden. Zeichenfolge
tableName Der Name der vorhandenen Zieltabelle in Ihrem Cluster, bei dem die Groß-/Kleinschreibung beachtet wird. Die abgerufenen Daten werden in dieser Tabelle erfasst. Zeichenfolge (erforderlich)

EventGridDataConnection

Name BESCHREIBUNG Wert
kind Art des Endpunkts für die Datenverbindung "EventGrid" (erforderlich)
properties Die Eigenschaften der Event Grid-Datenverbindung. EventGridConnectionProperties

EventGridConnectionProperties

Name BESCHREIBUNG Wert
blobStorageEventType Der Name des zu verarbeitenden Blob Storage-Ereignistyps. "Microsoft.Storage.BlobCreated"
"Microsoft.Storage.BlobRenamed"
consumerGroup Die Event Hub-Consumergruppe. Zeichenfolge (erforderlich)
databaseRouting Anzeige für Datenbankroutinginformationen aus der Datenverbindung. Standardmäßig sind nur Datenbankroutinginformationen zulässig. „Multi“
"Single"
dataFormat Das Datenformat der Nachricht. Optional kann jeder Nachricht das Datenformat hinzugefügt werden. "APACHEAVRO"
"AVRO"
"CSV"
"JSON"
"MULTIJSON"
"ORC"
"PARQUET"
"PSV"
RAW
"SCSV"
"SINGLEJSON"
"SOHSV"
"TSV"
"TSVE"
"TXT"
"W3CLOGFILE"
eventGridResourceId Die Ressourcen-ID des Event Grids, das die Speicherkontoereignisse abonniert ist. Zeichenfolge
eventHubResourceId Die Ressourcen-ID, in der das Event Grid zum Senden von Ereignissen konfiguriert ist. Zeichenfolge (erforderlich)
ignoreFirstRecord Ein boolescher Wert, der bei Festlegung auf TRUE angibt, dass die Erfassung den ersten Datensatz jeder Datei ignorieren sollte. bool
managedIdentityResourceId Die Ressourcen-ID einer verwalteten Identität (system- oder benutzerseitig zugewiesen), die für die Authentifizierung beim Event Hub und speicherkonto verwendet werden soll. Zeichenfolge
mappingRuleName Die Zuordnungsregel, die zum Erfassen der Daten verwendet werden soll. Optional können die Zuordnungsinformationen zu jeder Nachricht hinzugefügt werden. Zeichenfolge
storageAccountResourceId Die Ressourcen-ID des Speicherkontos, in dem sich die Daten befinden. Zeichenfolge (erforderlich)
tableName Die Tabelle, in der die Daten erfasst werden sollen. Optional können die Tabelleninformationen zu jeder Nachricht hinzugefügt werden. Zeichenfolge

EventHubDataConnection

Name BESCHREIBUNG Wert
kind Art des Endpunkts für die Datenverbindung "EventHub" (erforderlich)
properties Die zu überprüfenden Event Hub-Datenverbindungseigenschaften. EventHubConnectionProperties

EventHubConnectionProperties

Name BESCHREIBUNG Wert
compression Der Event Hub-Nachrichtenkomprimierungstyp "GZip"
"None"
consumerGroup Die Event Hub-Consumergruppe. Zeichenfolge (erforderlich)
databaseRouting Anzeige für Datenbankroutinginformationen aus der Datenverbindung. Standardmäßig sind nur Datenbankroutinginformationen zulässig. „Multi“
"Single"
dataFormat Das Datenformat der Nachricht. Optional kann jeder Nachricht das Datenformat hinzugefügt werden. "APACHEAVRO"
"AVRO"
"CSV"
"JSON"
"MULTIJSON"
"ORC"
"PARQUET"
"PSV"
RAW
"SCSV"
"SINGLEJSON"
"SOHSV"
"TSV"
"TSVE"
"TXT"
"W3CLOGFILE"
eventHubResourceId Die Ressourcen-ID des Event Hubs, der 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 benutzerseitig zugewiesen), die für die Authentifizierung beim Event Hub verwendet werden soll. Zeichenfolge
mappingRuleName Die Zuordnungsregel, die zum Erfassen der Daten verwendet werden soll. Optional können die Zuordnungsinformationen zu jeder Nachricht hinzugefügt werden. Zeichenfolge
retrievalStartDate Wenn sie definiert ist, ruft die Datenverbindung vorhandene Event Hub-Ereignisse ab, die seit dem Startdatum des Abrufs erstellt wurden. Es kann nur Ereignisse abrufen, die vom Event Hub aufbewahrt werden, basierend auf seinem Aufbewahrungszeitraum. Zeichenfolge
tableName Die Tabelle, in der die Daten erfasst werden sollen. Optional können die Tabelleninformationen zu jeder Nachricht hinzugefügt werden. Zeichenfolge

IotHubDataConnection

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

IotHubConnectionProperties

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