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:
- Ressourcengruppen – Siehe Ressourcengruppenbereitstellungsbefehle
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:
- Ressourcengruppen – Siehe Ressourcengruppenbereitstellungsbefehle
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 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. |
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" |