New-AzKustoDataConnection

참조

모듈:: Az.Kusto

데이터 연결을 만들거나 업데이트합니다.

구문

New-AzKustoDataConnection
   -ClusterName <String>
   -DatabaseName <String>
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Kind <Kind>
   -Location <String>
   [-TableName <String>]
   -EventHubResourceId <String>
   -ConsumerGroup <String>
   [-DataFormat <String>]
   [-EventSystemProperty <String[]>]
   [-MappingRuleName <String>]
   [-Compression <Compression>]
   [-ManagedIdentityResourceId <String>]
   [-DatabaseRouting <DatabaseRouting>]
   [-RetrievalStartDate <DateTime>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzKustoDataConnection
   -ClusterName <String>
   -DatabaseName <String>
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Kind <Kind>
   -Location <String>
   [-TableName <String>]
   -EventHubResourceId <String>
   -ConsumerGroup <String>
   [-DataFormat <String>]
   [-MappingRuleName <String>]
   [-ManagedIdentityResourceId <String>]
   [-DatabaseRouting <DatabaseRouting>]
   -StorageAccountResourceId <String>
   [-BlobStorageEventType <BlobStorageEventType>]
   [-IgnoreFirstRecord]
   [-EventGridResourceId <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzKustoDataConnection
   -ClusterName <String>
   -DatabaseName <String>
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Kind <Kind>
   -Location <String>
   [-TableName <String>]
   -ConsumerGroup <String>
   [-DataFormat <String>]
   [-EventSystemProperty <String[]>]
   [-MappingRuleName <String>]
   [-DatabaseRouting <DatabaseRouting>]
   [-RetrievalStartDate <DateTime>]
   -IotHubResourceId <String>
   -SharedAccessPolicyName <String>
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzKustoDataConnection
   -ClusterName <String>
   -DatabaseName <String>
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Kind <Kind>
   -Location <String>
   [-TableName <String>]
   [-MappingRuleName <String>]
   -ManagedIdentityResourceId <String>
   [-RetrievalStartDate <DateTime>]
   -CosmosDbAccountResourceId <String>
   -CosmosDbDatabase <String>
   -CosmosDbContainer <String>
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

데이터 연결을 만들거나 업데이트합니다.

예제

예제 1: 새 EventHub 데이터 연결 만들기

New-AzKustoDataConnection -ResourceGroupName "testrg" -ClusterName "testnewkustocluster" -DatabaseName "mykustodatabase" -DataConnectionName "myeventhubdc" -Location "East US" -Kind "EventHub" -EventHubResourceId "/subscriptions/$subscriptionId/resourcegroups/testrg/providers/Microsoft.EventHub/namespaces/myeventhubns/eventhubs/myeventhub" -DataFormat "MULTIJSON" -ConsumerGroup '$Default' -Compression "None" -TableName "Events" -MappingRuleName "EventsMapping"

Kind     Location Name                                             Type
----     -------- ----                                             ----
EventHub East US  testnewkustocluster/mykustodatabase/myeventhubdc Microsoft.Kusto/Clusters/Databases/DataConnections

위의 명령은 클러스터 "testnewkustocluster"에서 데이터베이스 "mykustodatabase"에 대해 "myeventhubdc"라는 새 EventHub 데이터 연결을 만듭니다.

예제 2: 새 EventGrid 데이터 연결 만들기

New-AzKustoDataConnection -ResourceGroupName "testrg" -ClusterName "testnewkustocluster" -DatabaseName "mykustodatabase" -DataConnectionName "myeventgriddc" -Location "East US" -Kind "EventGrid" -EventHubResourceId "/subscriptions/$subscriptionId/resourcegroups/testrg/providers/Microsoft.EventHub/namespaces/myeventhubns/eventhubs/myeventhub" -StorageAccountResourceId "/subscriptions/$subscriptionId/resourcegroups/testrg/providers/Microsoft.Storage/storageAccounts/mystorage" -DataFormat "MULTIJSON" -ConsumerGroup '$Default' -TableName "Events" -MappingRuleName "EventsMapping"

Kind      Location Name                                              Type
----      -------- ----                                              ----
EventGrid East US  testnewkustocluster/mykustodatabase/myeventgriddc Microsoft.Kusto/Clusters/Databases/DataConnections

위의 명령은 클러스터 "testnewkustocluster"에서 데이터베이스 "mykustodatabase"에 대해 "myeventgriddc"라는 새 EventGrid 데이터 연결을 만듭니다.

예제 3: 새 IotHub 데이터 연결 만들기

New-AzKustoDataConnection -ResourceGroupName "testrg" -ClusterName "testnewkustocluster" -DatabaseName "mykustodatabase" -DataConnectionName "myiothubdc" -Location "East US" -Kind "IotHub" -IotHubResourceId "/subscriptions/$subscriptionId/resourcegroups/testrg/providers/Microsoft.Devices/IotHubs/myiothub" -SharedAccessPolicyName "myiothubpolicy" -DataFormat "MULTIJSON" -ConsumerGroup '$Default' -TableName "Events" -MappingRuleName "EventsMapping"

Kind      Location Name                                        Type
----      -------- ----                                        ----
IotHub East US  testnewkustocluster/mykustodatabase/myiothubdc Microsoft.Kusto/Clusters/Databases/DataConnections

위의 명령은 클러스터 "testnewkustocluster"에서 데이터베이스 "mykustodatabase"에 대해 "myiothubdc"라는 새 IotHub 데이터 연결을 만듭니다.

매개 변수

-AsJob

작업으로 명령 실행

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-BlobStorageEventType

처리할 Blob Storage 이벤트 유형의 이름입니다.

형식:	BlobStorageEventType
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ClusterName

Kusto 클러스터의 이름입니다.

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Compression

이벤트 허브 메시지 압축 유형입니다.

형식:	Compression
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

형식:	SwitchParameter
별칭:	cf
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ConsumerGroup

이벤트/IoT 허브 소비자 그룹입니다.

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-CosmosDbAccountResourceId

데이터 연결을 만드는 데 사용되는 Cosmos DB 계정의 리소스 ID입니다.

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-CosmosDbContainer

Cosmos DB 데이터베이스에 있는 기존 컨테이너의 이름입니다.

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-CosmosDbDatabase

Cosmos DB 계정에 있는 기존 데이터베이스의 이름입니다.

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DatabaseName

Kusto 클러스터에 있는 데이터베이스의 이름입니다.

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DatabaseRouting

데이터 연결의 데이터베이스 라우팅 정보에 대한 표시이며, 기본적으로 데이터베이스 라우팅 정보만 허용됩니다.

형식:	DatabaseRouting
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DataFormat

메시지의 데이터 형식입니다. 필요에 따라 각 메시지에 데이터 형식을 추가할 수 있습니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

형식:	PSObject
별칭:	AzureRMContext, AzureCredential
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-EventGridResourceId

스토리지 계정 이벤트를 구독하는 이벤트 그리드의 리소스 ID입니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-EventHubResourceId

데이터 연결/이벤트 그리드를 만드는 데 사용할 이벤트 허브의 리소스 ID는 이벤트를 보내도록 구성됩니다.

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-EventSystemProperty

이벤트/IoT 허브의 시스템 속성입니다.

형식:	String[]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-IgnoreFirstRecord

true로 설정하면 수집에서 모든 파일의 첫 번째 레코드를 무시해야 함을 나타냅니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-IotHubResourceId

데이터 연결을 만드는 데 사용할 IoT 허브의 리소스 ID입니다.

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Kind

데이터 연결에 대한 엔드포인트의 종류

형식:	Kind
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Location

리소스 위치입니다.

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ManagedIdentityResourceId

외부 리소스로 인증하는 데 사용할 관리 ID(시스템 또는 사용자 할당)의 리소스 ID입니다.

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-MappingRuleName

데이터를 수집하는 데 사용할 매핑 규칙입니다. 필요에 따라 매핑 정보를 각 메시지에 추가할 수 있습니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Name

데이터 연결의 이름입니다.

형식:	String
별칭:	DataConnectionName
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-NoWait

명령을 비동기적으로 실행

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ResourceGroupName

Kusto 클러스터를 포함하는 리소스 그룹의 이름입니다.

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-RetrievalStartDate

정의된 경우 데이터 연결은 검색 시작 날짜 이후 생성된 기존 이벤트 허브 이벤트를 검색합니다. 보존 기간에 따라 이벤트 허브에서 보존하는 이벤트만 검색할 수 있습니다.

형식:	DateTime
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-SharedAccessPolicyName

공유 액세스 정책의 이름입니다.

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-StorageAccountResourceId

데이터가 있는 스토리지 계정의 리소스 ID입니다.

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-SubscriptionId

Microsoft Azure 구독을 고유하게 식별하는 구독 자격 증명을 가져옵니다. 구독 ID는 모든 서비스 호출에 대한 URI의 일부를 형성합니다.

형식:	String
Position:	Named
Default value:	(Get-AzContext).Subscription.Id
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-TableName

데이터를 수집해야 하는 테이블입니다. 필요에 따라 각 메시지에 테이블 정보를 추가할 수 있습니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

형식:	SwitchParameter
별칭:	wi
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

출력

IDataConnection

다음을 통해 공유