英語で読む

次の方法で共有


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

デプロイ言語を選択する

Bicep リソース定義

クラスター/データベース/dataConnections リソースの種類は、次を対象とする操作でデプロイできます。

  • リソース グループの - リソース グループのデプロイ コマンド 参照

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.Kusto/clusters/databases/dataConnections リソースを作成するには、次の Bicep をテンプレートに追加します。

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

clusters/databases/dataConnections オブジェクト

の種類 プロパティを設定して、オブジェクトの種類を指定します。

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'
  }

EventHubの場合は、次を使用します。

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

IotHubの場合は、次を使用します。

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

プロパティ値

clusters/databases/dataConnections

名前 形容 価値
名前 リソース名

Bicepで子リソースの名前と種類 設定する方法を参照してください。
string (必須)
場所 リソースの場所。
種類 オブジェクトの種類を設定する EventGrid の
EventHub
IotHub (必須)
Bicep では、子リソースの親リソースを指定できます。 このプロパティを追加する必要があるのは、子リソースが親リソースの外部で宣言されている場合のみです。

詳細については、「親リソースの外部 子リソース」を参照してください。
種類のリソースのシンボリック名: データベース

EventGridDataConnection

名前 形容 価値
種類 データ接続のエンドポイントの種類 'EventGrid' (必須)
プロパティ Event Grid データ接続のプロパティ。 EventGridConnectionProperties の

EventGridConnectionProperties

名前 形容 価値
blobStorageEventType 処理する BLOB ストレージ イベントの種類の名前。 'Microsoft.Storage.BlobCreated'
'Microsoft.Storage.BlobRenamed'
consumerGroup イベント ハブ コンシューマー グループ。 string (必須)
databaseRouting データ接続からのデータベース ルーティング情報を示します。既定では、データベース ルーティング情報のみが許可されます 'Multi'
'Single'
dataFormat メッセージのデータ形式。 必要に応じて、各メッセージにデータ形式を追加できます。 'APACHEAVRO'
'AVRO'
'CSV'
'JSON'
'MULTIJSON'
'ORC'
'PARQUET'
'PSV'
'RAW'
'SCSV'
'SINGLEJSON'
'SOHSV'
'TSV'
'TSVE'
'TXT'
'W3CLOGFILE'
eventGridResourceId ストレージ アカウント イベントにサブスクライブされているイベント グリッドのリソース ID。
eventHubResourceId イベントを送信するようにイベント グリッドが構成されているリソース ID。 string (必須)
ignoreFirstRecord true に設定されている場合、インジェストはすべてのファイルの最初のレコードを無視する必要があることを示すブール値です。 bool
managedIdentityResourceId イベント ハブとストレージ アカウントで認証するために使用されるマネージド ID (システムまたはユーザー割り当て) のリソース ID。
mappingRuleName データの取り込みに使用するマッピング ルール。 必要に応じて、マッピング情報を各メッセージに追加できます。
storageAccountResourceId データが存在するストレージ アカウントのリソース ID。 string (必須)
tableName データを取り込むテーブル。 必要に応じて、各メッセージにテーブル情報を追加できます。

EventHubDataConnection

名前 形容 価値
種類 データ接続のエンドポイントの種類 'EventHub' (必須)
プロパティ 検証する Event Hub データ接続プロパティ。 EventHubConnectionProperties の

EventHubConnectionProperties

名前 形容 価値
圧縮 イベント ハブ メッセージの圧縮の種類 'GZip'
'None'
consumerGroup イベント ハブ コンシューマー グループ。 string (必須)
databaseRouting データ接続からのデータベース ルーティング情報を示します。既定では、データベース ルーティング情報のみが許可されます 'Multi'
'Single'
dataFormat メッセージのデータ形式。 必要に応じて、各メッセージにデータ形式を追加できます。 'APACHEAVRO'
'AVRO'
'CSV'
'JSON'
'MULTIJSON'
'ORC'
'PARQUET'
'PSV'
'RAW'
'SCSV'
'SINGLEJSON'
'SOHSV'
'TSV'
'TSVE'
'TXT'
'W3CLOGFILE'
eventHubResourceId データ接続の作成に使用するイベント ハブのリソース ID。 string (必須)
eventSystemProperties イベント ハブのシステム プロパティ string[]
managedIdentityResourceId イベント ハブでの認証に使用するマネージド ID (システムまたはユーザー割り当て) のリソース ID。
mappingRuleName データの取り込みに使用するマッピング ルール。 必要に応じて、マッピング情報を各メッセージに追加できます。
retrievalStartDate 定義すると、データ接続は取得開始日以降に作成された既存のイベント ハブ イベントを取得します。 保持期間に基づいて、イベント ハブによって保持されるイベントのみを取得できます。
tableName データを取り込むテーブル。 必要に応じて、各メッセージにテーブル情報を追加できます。

IotHubDataConnection

名前 形容 価値
種類 データ接続のエンドポイントの種類 'IotHub' (必須)
プロパティ IoT Hub データ接続のプロパティ。 IotHubConnectionProperties の

IotHubConnectionProperties

名前 形容 価値
consumerGroup IoT ハブ コンシューマー グループ。 string (必須)
databaseRouting データ接続からのデータベース ルーティング情報を示します。既定では、データベース ルーティング情報のみが許可されます 'Multi'
'Single'
dataFormat メッセージのデータ形式。 必要に応じて、各メッセージにデータ形式を追加できます。 'APACHEAVRO'
'AVRO'
'CSV'
'JSON'
'MULTIJSON'
'ORC'
'PARQUET'
'PSV'
'RAW'
'SCSV'
'SINGLEJSON'
'SOHSV'
'TSV'
'TSVE'
'TXT'
'W3CLOGFILE'
eventSystemProperties IoT ハブのシステム プロパティ string[]
iotHubResourceId データ接続の作成に使用する IoT ハブのリソース ID。 string (必須)
mappingRuleName データの取り込みに使用するマッピング ルール。 必要に応じて、マッピング情報を各メッセージに追加できます。
retrievalStartDate 定義すると、データ接続は取得開始日以降に作成された既存のイベント ハブ イベントを取得します。 保持期間に基づいて、イベント ハブによって保持されるイベントのみを取得できます。
sharedAccessPolicyName 共有アクセス ポリシーの名前 string (必須)
tableName データを取り込むテーブル。 必要に応じて、各メッセージにテーブル情報を追加できます。

クイック スタート テンプレート

次のクイック スタート テンプレートでは、このリソースの種類をデプロイします。

テンプレート 形容
Cosmos DB 接続 を使用して Azure Data Explorer DB をデプロイする

Azure にデプロイする
Cosmos DB 接続を使用して Azure Data Explorer DB をデプロイします。
Event Grid 接続 を使用して Azure Data Explorer db をデプロイ

Azure
にデプロイする
Event Grid 接続を使用して Azure Data Explorer db をデプロイします。
Event Hub 接続 を使用して Azure Data Explorer db をデプロイする

Azure にデプロイする
Event Hub 接続を使用して Azure Data Explorer db をデプロイします。

ARM テンプレート リソース定義

クラスター/データベース/dataConnections リソースの種類は、次を対象とする操作でデプロイできます。

  • リソース グループの - リソース グループのデプロイ コマンド 参照

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.Kusto/clusters/databases/dataConnections リソースを作成するには、次の JSON をテンプレートに追加します。

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

clusters/databases/dataConnections オブジェクト

の種類 プロパティを設定して、オブジェクトの種類を指定します。

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

EventHubの場合は、次を使用します。

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

IotHubの場合は、次を使用します。

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

プロパティ値

clusters/databases/dataConnections

名前 形容 価値
種類 リソースの種類 'Microsoft.Kusto/clusters/databases/dataConnections'
apiVersion リソース API のバージョン '2022-07-07'
名前 リソース名

JSON ARM テンプレートで子リソースの名前と型 設定する方法を参照してください。
string (必須)
場所 リソースの場所。
種類 オブジェクトの種類を設定する EventGrid の
EventHub
IotHub (必須)

EventGridDataConnection

名前 形容 価値
種類 データ接続のエンドポイントの種類 'EventGrid' (必須)
プロパティ Event Grid データ接続のプロパティ。 EventGridConnectionProperties の

EventGridConnectionProperties

名前 形容 価値
blobStorageEventType 処理する BLOB ストレージ イベントの種類の名前。 'Microsoft.Storage.BlobCreated'
'Microsoft.Storage.BlobRenamed'
consumerGroup イベント ハブ コンシューマー グループ。 string (必須)
databaseRouting データ接続からのデータベース ルーティング情報を示します。既定では、データベース ルーティング情報のみが許可されます 'Multi'
'Single'
dataFormat メッセージのデータ形式。 必要に応じて、各メッセージにデータ形式を追加できます。 'APACHEAVRO'
'AVRO'
'CSV'
'JSON'
'MULTIJSON'
'ORC'
'PARQUET'
'PSV'
'RAW'
'SCSV'
'SINGLEJSON'
'SOHSV'
'TSV'
'TSVE'
'TXT'
'W3CLOGFILE'
eventGridResourceId ストレージ アカウント イベントにサブスクライブされているイベント グリッドのリソース ID。
eventHubResourceId イベントを送信するようにイベント グリッドが構成されているリソース ID。 string (必須)
ignoreFirstRecord true に設定されている場合、インジェストはすべてのファイルの最初のレコードを無視する必要があることを示すブール値です。 bool
managedIdentityResourceId イベント ハブとストレージ アカウントで認証するために使用されるマネージド ID (システムまたはユーザー割り当て) のリソース ID。
mappingRuleName データの取り込みに使用するマッピング ルール。 必要に応じて、マッピング情報を各メッセージに追加できます。
storageAccountResourceId データが存在するストレージ アカウントのリソース ID。 string (必須)
tableName データを取り込むテーブル。 必要に応じて、各メッセージにテーブル情報を追加できます。

EventHubDataConnection

名前 形容 価値
種類 データ接続のエンドポイントの種類 'EventHub' (必須)
プロパティ 検証する Event Hub データ接続プロパティ。 EventHubConnectionProperties の

EventHubConnectionProperties

名前 形容 価値
圧縮 イベント ハブ メッセージの圧縮の種類 'GZip'
'None'
consumerGroup イベント ハブ コンシューマー グループ。 string (必須)
databaseRouting データ接続からのデータベース ルーティング情報を示します。既定では、データベース ルーティング情報のみが許可されます 'Multi'
'Single'
dataFormat メッセージのデータ形式。 必要に応じて、各メッセージにデータ形式を追加できます。 'APACHEAVRO'
'AVRO'
'CSV'
'JSON'
'MULTIJSON'
'ORC'
'PARQUET'
'PSV'
'RAW'
'SCSV'
'SINGLEJSON'
'SOHSV'
'TSV'
'TSVE'
'TXT'
'W3CLOGFILE'
eventHubResourceId データ接続の作成に使用するイベント ハブのリソース ID。 string (必須)
eventSystemProperties イベント ハブのシステム プロパティ string[]
managedIdentityResourceId イベント ハブでの認証に使用するマネージド ID (システムまたはユーザー割り当て) のリソース ID。
mappingRuleName データの取り込みに使用するマッピング ルール。 必要に応じて、マッピング情報を各メッセージに追加できます。
retrievalStartDate 定義すると、データ接続は取得開始日以降に作成された既存のイベント ハブ イベントを取得します。 保持期間に基づいて、イベント ハブによって保持されるイベントのみを取得できます。
tableName データを取り込むテーブル。 必要に応じて、各メッセージにテーブル情報を追加できます。

IotHubDataConnection

名前 形容 価値
種類 データ接続のエンドポイントの種類 'IotHub' (必須)
プロパティ IoT Hub データ接続のプロパティ。 IotHubConnectionProperties の

IotHubConnectionProperties

名前 形容 価値
consumerGroup IoT ハブ コンシューマー グループ。 string (必須)
databaseRouting データ接続からのデータベース ルーティング情報を示します。既定では、データベース ルーティング情報のみが許可されます 'Multi'
'Single'
dataFormat メッセージのデータ形式。 必要に応じて、各メッセージにデータ形式を追加できます。 'APACHEAVRO'
'AVRO'
'CSV'
'JSON'
'MULTIJSON'
'ORC'
'PARQUET'
'PSV'
'RAW'
'SCSV'
'SINGLEJSON'
'SOHSV'
'TSV'
'TSVE'
'TXT'
'W3CLOGFILE'
eventSystemProperties IoT ハブのシステム プロパティ string[]
iotHubResourceId データ接続の作成に使用する IoT ハブのリソース ID。 string (必須)
mappingRuleName データの取り込みに使用するマッピング ルール。 必要に応じて、マッピング情報を各メッセージに追加できます。
retrievalStartDate 定義すると、データ接続は取得開始日以降に作成された既存のイベント ハブ イベントを取得します。 保持期間に基づいて、イベント ハブによって保持されるイベントのみを取得できます。
sharedAccessPolicyName 共有アクセス ポリシーの名前 string (必須)
tableName データを取り込むテーブル。 必要に応じて、各メッセージにテーブル情報を追加できます。

クイック スタート テンプレート

次のクイック スタート テンプレートでは、このリソースの種類をデプロイします。

テンプレート 形容
Cosmos DB 接続 を使用して Azure Data Explorer DB をデプロイする

Azure にデプロイする
Cosmos DB 接続を使用して Azure Data Explorer DB をデプロイします。
Event Grid 接続 を使用して Azure Data Explorer db をデプロイ

Azure
にデプロイする
Event Grid 接続を使用して Azure Data Explorer db をデプロイします。
Event Hub 接続 を使用して Azure Data Explorer db をデプロイする

Azure にデプロイする
Event Hub 接続を使用して Azure Data Explorer db をデプロイします。

Terraform (AzAPI プロバイダー) リソース定義

クラスター/データベース/dataConnections リソースの種類は、次を対象とする操作でデプロイできます。

  • リソース グループの

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.Kusto/clusters/databases/dataConnections リソースを作成するには、次の Terraform をテンプレートに追加します。

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

clusters/databases/dataConnections オブジェクト

の種類 プロパティを設定して、オブジェクトの種類を指定します。

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

EventHubの場合は、次を使用します。

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

IotHubの場合は、次を使用します。

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

プロパティ値

clusters/databases/dataConnections

名前 形容 価値
種類 リソースの種類 "Microsoft.Kusto/clusters/databases/dataConnections@2022-07-07"
名前 リソース名 string (必須)
場所 リソースの場所。
parent_id このリソースの親であるリソースの ID。 種類のリソースの ID: データベース
種類 オブジェクトの種類を設定する EventGrid の
EventHub
IotHub (必須)

EventGridDataConnection

名前 形容 価値
種類 データ接続のエンドポイントの種類 "EventGrid" (必須)
プロパティ Event Grid データ接続のプロパティ。 EventGridConnectionProperties の

EventGridConnectionProperties

名前 形容 価値
blobStorageEventType 処理する BLOB ストレージ イベントの種類の名前。 "Microsoft.Storage.BlobCreated"
"Microsoft.Storage.BlobRenamed"
consumerGroup イベント ハブ コンシューマー グループ。 string (必須)
databaseRouting データ接続からのデータベース ルーティング情報を示します。既定では、データベース ルーティング情報のみが許可されます "Multi"
"Single"
dataFormat メッセージのデータ形式。 必要に応じて、各メッセージにデータ形式を追加できます。 "APACHEAVRO"
"AVRO"
"CSV"
"JSON"
"MULTIJSON"
"ORC"
"PARQUET"
"PSV"
"RAW"
"SCSV"
"SINGLEJSON"
"SOHSV"
"TSV"
"TSVE"
"TXT"
"W3CLOGFILE"
eventGridResourceId ストレージ アカウント イベントにサブスクライブされているイベント グリッドのリソース ID。
eventHubResourceId イベントを送信するようにイベント グリッドが構成されているリソース ID。 string (必須)
ignoreFirstRecord true に設定されている場合、インジェストはすべてのファイルの最初のレコードを無視する必要があることを示すブール値です。 bool
managedIdentityResourceId イベント ハブとストレージ アカウントで認証するために使用されるマネージド ID (システムまたはユーザー割り当て) のリソース ID。
mappingRuleName データの取り込みに使用するマッピング ルール。 必要に応じて、マッピング情報を各メッセージに追加できます。
storageAccountResourceId データが存在するストレージ アカウントのリソース ID。 string (必須)
tableName データを取り込むテーブル。 必要に応じて、各メッセージにテーブル情報を追加できます。

EventHubDataConnection

名前 形容 価値
種類 データ接続のエンドポイントの種類 "EventHub" (必須)
プロパティ 検証する Event Hub データ接続プロパティ。 EventHubConnectionProperties の

EventHubConnectionProperties

名前 形容 価値
圧縮 イベント ハブ メッセージの圧縮の種類 "GZip"
"なし"
consumerGroup イベント ハブ コンシューマー グループ。 string (必須)
databaseRouting データ接続からのデータベース ルーティング情報を示します。既定では、データベース ルーティング情報のみが許可されます "Multi"
"Single"
dataFormat メッセージのデータ形式。 必要に応じて、各メッセージにデータ形式を追加できます。 "APACHEAVRO"
"AVRO"
"CSV"
"JSON"
"MULTIJSON"
"ORC"
"PARQUET"
"PSV"
"RAW"
"SCSV"
"SINGLEJSON"
"SOHSV"
"TSV"
"TSVE"
"TXT"
"W3CLOGFILE"
eventHubResourceId データ接続の作成に使用するイベント ハブのリソース ID。 string (必須)
eventSystemProperties イベント ハブのシステム プロパティ string[]
managedIdentityResourceId イベント ハブでの認証に使用するマネージド ID (システムまたはユーザー割り当て) のリソース ID。
mappingRuleName データの取り込みに使用するマッピング ルール。 必要に応じて、マッピング情報を各メッセージに追加できます。
retrievalStartDate 定義すると、データ接続は取得開始日以降に作成された既存のイベント ハブ イベントを取得します。 保持期間に基づいて、イベント ハブによって保持されるイベントのみを取得できます。
tableName データを取り込むテーブル。 必要に応じて、各メッセージにテーブル情報を追加できます。

IotHubDataConnection

名前 形容 価値
種類 データ接続のエンドポイントの種類 "IotHub" (必須)
プロパティ IoT Hub データ接続のプロパティ。 IotHubConnectionProperties の

IotHubConnectionProperties

名前 形容 価値
consumerGroup IoT ハブ コンシューマー グループ。 string (必須)
databaseRouting データ接続からのデータベース ルーティング情報を示します。既定では、データベース ルーティング情報のみが許可されます "Multi"
"Single"
dataFormat メッセージのデータ形式。 必要に応じて、各メッセージにデータ形式を追加できます。 "APACHEAVRO"
"AVRO"
"CSV"
"JSON"
"MULTIJSON"
"ORC"
"PARQUET"
"PSV"
"RAW"
"SCSV"
"SINGLEJSON"
"SOHSV"
"TSV"
"TSVE"
"TXT"
"W3CLOGFILE"
eventSystemProperties IoT ハブのシステム プロパティ string[]
iotHubResourceId データ接続の作成に使用する IoT ハブのリソース ID。 string (必須)
mappingRuleName データの取り込みに使用するマッピング ルール。 必要に応じて、マッピング情報を各メッセージに追加できます。
retrievalStartDate 定義すると、データ接続は取得開始日以降に作成された既存のイベント ハブ イベントを取得します。 保持期間に基づいて、イベント ハブによって保持されるイベントのみを取得できます。
sharedAccessPolicyName 共有アクセス ポリシーの名前 string (必須)
tableName データを取り込むテーブル。 必要に応じて、各メッセージにテーブル情報を追加できます。