你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

New-AzSynapseKustoPoolDataConnection

创建或更新数据连接。

语法

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>]

说明

创建或更新数据连接。

示例

示例 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

用于创建数据连接/事件网格的事件中心的资源 ID 配置为发送事件。

类型: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 中心的资源 ID。

类型: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

数据所在的存储帐户的资源 ID。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-SubscriptionId

目标订阅的 ID。

类型: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

输出

IDataConnection