Udostępnij za pośrednictwem

New-AzSynapseKustoPoolDataConnection

Moduł:
Az.Synapse Module

Tworzy lub aktualizuje połączenie danych.

Składnia

CreateExpandedEventHub (domyślnie) 

New-AzSynapseKustoPoolDataConnection
    -DataConnectionName <String>
    -DatabaseName <String>
    -KustoPoolName <String>
    -ResourceGroupName <String>
    -WorkspaceName <String>
    -Kind <DataConnectionKind>
    -ConsumerGroup <String>
    -Location <String>
    -EventHubResourceId <String>
    [-SubscriptionId <String>]
    [-DataFormat <EventGridDataFormat>]
    [-EventSystemProperty <String[]>]
    [-MappingRuleName <String>]
    [-TableName <String>]
    [-Compression <Compression>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-Break]
    [-HttpPipelineAppend <SendAsyncStep[]>]
    [-HttpPipelinePrepend <SendAsyncStep[]>]
    [-NoWait]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-ProxyUseDefaultCredentials]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateExpandedEventGrid 

New-AzSynapseKustoPoolDataConnection
    -DataConnectionName <String>
    -DatabaseName <String>
    -KustoPoolName <String>
    -ResourceGroupName <String>
    -WorkspaceName <String>
    -Kind <DataConnectionKind>
    -ConsumerGroup <String>
    -Location <String>
    -EventHubResourceId <String>
    -StorageAccountResourceId <String>
    [-SubscriptionId <String>]
    [-DataFormat <EventGridDataFormat>]
    [-MappingRuleName <String>]
    [-TableName <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-Break]
    [-HttpPipelineAppend <SendAsyncStep[]>]
    [-HttpPipelinePrepend <SendAsyncStep[]>]
    [-NoWait]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-ProxyUseDefaultCredentials]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateExpandedIotHub 

New-AzSynapseKustoPoolDataConnection
    -DataConnectionName <String>
    -DatabaseName <String>
    -KustoPoolName <String>
    -ResourceGroupName <String>
    -WorkspaceName <String>
    -Kind <DataConnectionKind>
    -ConsumerGroup <String>
    -Location <String>
    -IotHubResourceId <String>
    -SharedAccessPolicyName <String>
    [-SubscriptionId <String>]
    [-DataFormat <EventGridDataFormat>]
    [-EventSystemProperty <String[]>]
    [-MappingRuleName <String>]
    [-TableName <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-Break]
    [-HttpPipelineAppend <SendAsyncStep[]>]
    [-HttpPipelinePrepend <SendAsyncStep[]>]
    [-NoWait]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-ProxyUseDefaultCredentials]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UpdateExpandedEventGrid 

New-AzSynapseKustoPoolDataConnection
    -DataConnectionName <String>
    -DatabaseName <String>
    -KustoPoolName <String>
    -ResourceGroupName <String>
    -WorkspaceName <String>
    -Kind <DataConnectionKind>
    -ConsumerGroup <String>
    -Location <String>
    [-SubscriptionId <String>]
    [-DataFormat <EventGridDataFormat>]
    [-MappingRuleName <String>]
    [-TableName <String>]
    [-BlobStorageEventType <BlobStorageEventType>]
    [-IgnoreFirstRecord]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-Break]
    [-HttpPipelineAppend <SendAsyncStep[]>]
    [-HttpPipelinePrepend <SendAsyncStep[]>]
    [-NoWait]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-ProxyUseDefaultCredentials]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UpdateViaIdentityExpandedEventGrid 

New-AzSynapseKustoPoolDataConnection
    -DataConnectionName <String>
    -DatabaseName <String>
    -KustoPoolName <String>
    -ResourceGroupName <String>
    -WorkspaceName <String>
    -Kind <DataConnectionKind>
    -ConsumerGroup <String>
    -Location <String>
    [-SubscriptionId <String>]
    [-DataFormat <EventGridDataFormat>]
    [-MappingRuleName <String>]
    [-TableName <String>]
    [-BlobStorageEventType <BlobStorageEventType>]
    [-IgnoreFirstRecord]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-Break]
    [-HttpPipelineAppend <SendAsyncStep[]>]
    [-HttpPipelinePrepend <SendAsyncStep[]>]
    [-NoWait]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-ProxyUseDefaultCredentials]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Opis

Tworzy lub aktualizuje połączenie danych.

Przykłady

Przykład 1. Tworzenie nowego połączenia danych usługi 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

Powyższe polecenie tworzy nowe połączenie danych usługi EventHub o nazwie "eventhubdc" dla bazy danych "testdatabase" w puli kusto "testkustopool".

Przykład 2. Tworzenie nowego połączenia danych usługi 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

Powyższe polecenie tworzy nowe połączenie danych EventGrid o nazwie "eventgriddc" dla bazy danych "testdatabase" w puli kusto "testkustopool".

Przykład 3. Tworzenie nowego połączenia danych 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

Powyższe polecenie tworzy nowe połączenie danych IotHub o nazwie "iothubdc" dla bazy danych "testdatabase" w puli kusto "testkustopool".

Parametry

-AsJob

Uruchamianie polecenia jako zadania

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-BlobStorageEventType

Nazwa typu zdarzenia magazynu obiektów blob do przetworzenia.

Właściwości parametru

Typ:BlobStorageEventType
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

UpdateExpandedEventGrid
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False
UpdateViaIdentityExpandedEventGrid
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Break

Poczekaj na dołączenie debugera .NET

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Compression

Typ kompresji komunikatów centrum zdarzeń.

Właściwości parametru

Typ:Compression
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

CreateExpandedEventHub
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Confirm

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:por

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ConsumerGroup

Grupa odbiorców centrum zdarzeń/iot.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-DatabaseName

Nazwa bazy danych w puli Kusto.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-DataConnectionName

Nazwa połączenia danych.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Nazwa

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-DataFormat

Format danych wiadomości. Opcjonalnie można dodać format danych do każdego komunikatu.

Właściwości parametru

Typ:EventGridDataFormat
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z Azure.

Właściwości parametru

Typ:PSObject
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:AzureRMContext, AzureCredential

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-EventHubResourceId

Identyfikator zasobu centrum zdarzeń, który ma być używany do tworzenia połączenia danych/usługi Event Grid, jest skonfigurowany do wysyłania zdarzeń.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

CreateExpandedEventHub
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False
CreateExpandedEventGrid
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-EventSystemProperty

Właściwości systemu centrum event/iot.

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

CreateExpandedEventHub
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False
CreateExpandedIotHub
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-HttpPipelineAppend

Kroki potoku sendAsync, które mają zostać dołączone do przodu potoku

Właściwości parametru

Typ:

SendAsyncStep[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-HttpPipelinePrepend

Kroki potoku sendAsync, które mają być poprzedzane przed potokiem

Właściwości parametru

Typ:

SendAsyncStep[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-IgnoreFirstRecord

Jeśli ustawiono wartość true, oznacza, że pozyskiwanie powinno ignorować pierwszy rekord każdego pliku.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

UpdateExpandedEventGrid
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False
UpdateViaIdentityExpandedEventGrid
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-IotHubResourceId

Identyfikator zasobu centrum IoT, który ma zostać użyty do utworzenia połączenia danych.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

CreateExpandedIotHub
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Kind

Rodzaj punktu końcowego dla połączenia danych

Właściwości parametru

Typ:DataConnectionKind
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-KustoPoolName

Nazwa puli Kusto.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Location

Lokalizacja zasobu.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-MappingRuleName

Reguła mapowania, która ma być używana do pozyskiwania danych. Opcjonalnie informacje o mapowaniu można dodać do każdego komunikatu.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-NoWait

Uruchom polecenie asynchronicznie

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Proxy

Identyfikator URI serwera proxy do użycia

Właściwości parametru

Typ:Uri
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ProxyCredential

Poświadczenia serwera proxy do użycia na potrzeby zdalnego wywołania

Właściwości parametru

Typ:PSCredential
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ProxyUseDefaultCredentials

Użyj domyślnych poświadczeń serwera proxy

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ResourceGroupName

Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-SharedAccessPolicyName

Nazwa zasad dostępu do udziału.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

CreateExpandedIotHub
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-StorageAccountResourceId

Identyfikator zasobu konta magazynu, w którym znajdują się dane.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

CreateExpandedEventGrid
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-SubscriptionId

Identyfikator subskrypcji docelowej.

Właściwości parametru

Typ:String
Domyślna wartość:(Get-AzContext).Subscription.Id
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-TableName

Tabela, w której dane powinny być pozyskiwane. Opcjonalnie informacje o tabeli można dodać do każdego komunikatu.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Wi

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-WorkspaceName

Nazwa obszaru roboczego

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

IDataConnection

Dane wyjściowe

IDataConnection