New-AzSynapseKustoPoolDataConnection

Reference

Modul:: Az.Synapse

Vytvoří nebo aktualizuje datové připojení.

Syntax

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

Vytvoří nebo aktualizuje datové připojení.

Příklady

Příklad 1: Vytvoření nového datového připojení EventHubu

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

Výše uvedený příkaz vytvoří nové datové připojení EventHub s názvem "eventhubdc" pro databázi "testdatabase" ve fondu Kusto "testkustopool".

Příklad 2: Vytvoření nového datového připojení 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

Výše uvedený příkaz vytvoří nové datové připojení EventGrid s názvem "eventgriddc" pro databázi "testdatabase" ve fondu Kusto "testkustopool".

Příklad 3: Vytvoření nového datového připojení 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

Výše uvedený příkaz vytvoří nové datové připojení IotHub s názvem "iothubdc" pro databázi "testdatabase" ve fondu Kusto "testkustopool".

Parametry

-AsJob

Spuštění příkazu jako úlohy

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BlobStorageEventType

Název typu události úložiště objektů blob, který se má zpracovat.

Type:	BlobStorageEventType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Compression

Typ komprese centra událostí.

Type:	Compression
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConsumerGroup

Skupina příjemců event/iot Hub.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DatabaseName

Název databáze ve fondu Kusto.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DataConnectionName

Název datového připojení.

Type:	String
Aliases:	Name
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DataFormat

Formát dat zprávy. Volitelně je možné do každé zprávy přidat datový formát.

Type:	EventGridDataFormat
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Type:	PSObject
Aliases:	AzureRMContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EventHubResourceId

ID prostředku centra událostí, které se má použít k vytvoření datového připojení nebo event gridu, je nakonfigurováno pro odesílání událostí.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-EventSystemProperty

Systémové vlastnosti centra událostí nebo iot.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IgnoreFirstRecord

Pokud je nastavená hodnota true, znamená to, že příjem dat by měl ignorovat první záznam každého souboru.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IotHubResourceId

ID prostředku centra IoT, které se má použít k vytvoření datového připojení.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Kind

Druh koncového bodu pro datové připojení

Type:	DataConnectionKind
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-KustoPoolName

Název fondu Kusto.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Location

Umístění prostředku

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-MappingRuleName

Pravidlo mapování, které se má použít k ingestování dat. Volitelně lze do každé zprávy přidat informace o mapování.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoWait

Asynchronní spuštění příkazu

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

Název skupiny zdrojů. Název nerozlišuje malá a velká písmena.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-SharedAccessPolicyName

Název zásady přístupu ke sdílené složce.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-StorageAccountResourceId

ID prostředku účtu úložiště, ve kterém se data nacházejí.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-SubscriptionId

ID cílového předplatného.

Type:	String
Position:	Named
Default value:	(Get-AzContext).Subscription.Id
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TableName

Tabulka, ve které se mají data ingestovat. Volitelně je možné do každé zprávy přidat informace o tabulce.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WorkspaceName

Název pracovního prostoru

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

Vstupy

IDataConnection

Výstupy