New-AzSynapseKustoPoolDataConnection

參考

模組:: Az.Synapse

建立或更新數據連線。

語法

New-AzSynapseKustoPoolDataConnection
   -DataConnectionName <String>
   -DatabaseName <String>
   -KustoPoolName <String>
   -ResourceGroupName <String>
   -WorkspaceName <String>
   [-SubscriptionId <String>]
   -Kind <DataConnectionKind>
   -ConsumerGroup <String>
   -Location <String>
   -EventHubResourceId <String>
   [-DataFormat <EventGridDataFormat>]
   [-EventSystemProperty <String[]>]
   [-MappingRuleName <String>]
   [-TableName <String>]
   [-Compression <Compression>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzSynapseKustoPoolDataConnection
   -DataConnectionName <String>
   -DatabaseName <String>
   -KustoPoolName <String>
   -ResourceGroupName <String>
   -WorkspaceName <String>
   [-SubscriptionId <String>]
   -Kind <DataConnectionKind>
   -ConsumerGroup <String>
   -Location <String>
   -EventHubResourceId <String>
   [-DataFormat <EventGridDataFormat>]
   [-MappingRuleName <String>]
   [-TableName <String>]
   -StorageAccountResourceId <String>
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzSynapseKustoPoolDataConnection
   -DataConnectionName <String>
   -DatabaseName <String>
   -KustoPoolName <String>
   -ResourceGroupName <String>
   -WorkspaceName <String>
   [-SubscriptionId <String>]
   -Kind <DataConnectionKind>
   -ConsumerGroup <String>
   -Location <String>
   [-DataFormat <EventGridDataFormat>]
   [-EventSystemProperty <String[]>]
   [-MappingRuleName <String>]
   [-TableName <String>]
   -IotHubResourceId <String>
   -SharedAccessPolicyName <String>
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzSynapseKustoPoolDataConnection
   -DataConnectionName <String>
   -DatabaseName <String>
   -KustoPoolName <String>
   -ResourceGroupName <String>
   -WorkspaceName <String>
   [-SubscriptionId <String>]
   -Kind <DataConnectionKind>
   -ConsumerGroup <String>
   -Location <String>
   [-DataFormat <EventGridDataFormat>]
   [-MappingRuleName <String>]
   [-TableName <String>]
   [-BlobStorageEventType <BlobStorageEventType>]
   [-IgnoreFirstRecord]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzSynapseKustoPoolDataConnection
   -DataConnectionName <String>
   -DatabaseName <String>
   -KustoPoolName <String>
   -ResourceGroupName <String>
   -WorkspaceName <String>
   [-SubscriptionId <String>]
   -Kind <DataConnectionKind>
   -ConsumerGroup <String>
   -Location <String>
   [-DataFormat <EventGridDataFormat>]
   [-MappingRuleName <String>]
   [-TableName <String>]
   [-BlobStorageEventType <BlobStorageEventType>]
   [-IgnoreFirstRecord]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

建立或更新數據連線。

範例

範例 1：建立新的 EventHub 數據連線

New-AzSynapseKustoPoolDataConnection -ResourceGroupName testrg -WorkspaceName testws -KustoPoolName testkustopool -DatabaseName testdatabase -Name eventhubdc -Location eastus2 -Kind EventHub -EventHubResourceId "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.EventHub/namespaces/testeventhubns/eventhubs/testeventhub" -DataFormat "JSON" -ConsumerGroup '$Default' -Compression "None" -TableName "Events" -MappingRuleName "EventsMapping"

Kind     Location  Name
----     --------  ----
EventHub East US 2 testws/testkustopool/testdatabase/eventhubdc

上述命令會為 kusto 集區「testkustopool」中的資料庫「testdatabase」建立名為「eventhubdc」的新 EventHub 數據連線。

範例 2：建立新的 EventGrid 數據連線

New-AzSynapseKustoPoolDataConnection -ResourceGroupName testrg -WorkspaceName testws -KustoPoolName testkustopool -DatabaseName testdatabase -Name eventgriddc -Location eastus2 -Kind EventGrid -EventHubResourceId "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.EventHub/namespaces/testeventhubns/eventhubs/testeventhub" -StorageAccountResourceId "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.Storage/storageAccounts/teststorage" -DataFormat "JSON" -ConsumerGroup '$Default' -TableName "Events" -MappingRuleName "EventsMapping"

Kind      Location  Name
----      --------  ----
EventGrid East US 2 testws/testkustopool/testdatabase/eventgriddc

上述命令會為 kusto 集區「testkustopool」中的資料庫「testdatabase」建立名為「eventgriddc」的新 EventGrid 數據連線。

範例 3：建立新的 IotHub 數據連線

New-AzSynapseKustoPoolDataConnection -ResourceGroupName testrg -WorkspaceName testws -KustoPoolName testkustopool -DatabaseName testdatabase -Name iothubdc -Location eastus2 -Kind IotHub -IotHubResourceId "/subscriptions/051ddeca-1ed6-4d8b-ba6f-1ff561e5f3b3/resourceGroups/ywtest/providers/Microsoft.Devices/IotHubs/ywtestiothub" -SharedAccessPolicyName registryRead -DataFormat "JSON" -ConsumerGroup '$Default' -TableName "Events" -MappingRuleName "EventsMapping"

Kind   Location  Name
----   --------  ----
IotHub East US 2 testws/testkustopool/testdatabase/iothubdc

上述命令會為 kusto 集區「testkustopool」中的資料庫「testdatabase」建立名為「iothubdc」的新 IotHub 數據連線。

參數

-AsJob

以作業身分執行命令

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-BlobStorageEventType

要處理的 Blob 記憶體事件類型名稱。

類型:	BlobStorageEventType
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Compression

事件中樞訊息壓縮類型。

類型:	Compression
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ConsumerGroup

事件/iot 中樞取用者群組。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-DatabaseName

Kusto 集區中的資料庫名稱。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-DataConnectionName

數據連接的名稱。

類型:	String
別名:	Name
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-DataFormat

訊息的數據格式。您可以選擇性地將資料格式新增至每個訊息。

類型:	EventGridDataFormat
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:	PSObject
別名:	AzureRMContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-EventHubResourceId

要用來建立數據連線/事件方格的事件中樞資源標識符已設定為傳送事件。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-EventSystemProperty

事件/iot 中樞的系統屬性。

類型:	String[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-IgnoreFirstRecord

如果設定為 true，表示擷取應該忽略每個檔案的第一筆記錄。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-IotHubResourceId

要用來建立數據連線之IoT中樞的資源標識碼。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-Kind

數據連線的端點種類

類型:	DataConnectionKind
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-KustoPoolName

Kusto 集區的名稱。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-Location

資源位置。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-MappingRuleName

要用來內嵌數據的對應規則。您可以選擇性地將對應資訊新增至每個訊息。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-NoWait

以異步方式執行命令

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ResourceGroupName

資源群組的名稱。名稱不區分大小寫。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-SharedAccessPolicyName

共用存取原則的名稱。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-StorageAccountResourceId

數據所在記憶體帳戶的資源標識碼。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-SubscriptionId

目標訂用帳戶的標識碼。

類型:	String
Position:	Named
預設值:	(Get-AzContext).Subscription.Id
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-TableName

應該內嵌數據的數據表。您可以選擇性地將資料表資訊新增至每個訊息。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。未執行 Cmdlet。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-WorkspaceName

工作區的名稱

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

輸入

IDataConnection

輸出