New-AzSynapseKustoPoolDataConnection
Cria ou atualiza uma conexão de dados.
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
Cria ou atualiza uma conexão de dados.
Exemplos
Exemplo 1: Criar uma nova conexão de dados do 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/eventhubdcO comando acima cria uma nova conexão de dados do EventHub chamada "eventhubdc" para o banco de dados "testdatabase" no pool kusto "testkustopool".
Exemplo 2: Criar uma nova conexão de dados 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/eventgriddcO comando acima cria uma nova conexão de dados EventGrid chamada "eventgriddc" para o banco de dados "testdatabase" no pool kusto "testkustopool".
Exemplo 3: Criar uma nova conexão de dados do 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/iothubdcO comando acima cria uma nova conexão de dados do IotHub chamada "iothubdc" para o banco de dados "testdatabase" no pool kusto "testkustopool".
Parâmetros
-AsJob
Executar o comando como um trabalho
| Tipo: | SwitchParameter |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BlobStorageEventType
O nome do tipo de evento de armazenamento de blob a ser processado.
| Tipo: | BlobStorageEventType |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Compression
O tipo de compactação de mensagens do hub de eventos.
| Tipo: | Compression |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Solicita a sua confirmação antes de executar o cmdlet.
| Tipo: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ConsumerGroup
O grupo de consumidores do hub de eventos/iot.
| Tipo: | String |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DatabaseName
O nome do banco de dados no pool Kusto.
| Tipo: | String |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DataConnectionName
O nome da conexão de dados.
| Tipo: | String |
| Aliases: | Name |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DataFormat
O formato de dados da mensagem. Opcionalmente, o formato de dados pode ser adicionado a cada mensagem.
| Tipo: | EventGridDataFormat |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.
| Tipo: | PSObject |
| Aliases: | AzureRMContext, AzureCredential |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EventHubResourceId
O ID de recurso do hub de eventos a ser usado para criar uma conexão de dados / grade de eventos é configurado para enviar eventos.
| Tipo: | String |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EventSystemProperty
Propriedades do sistema do hub de eventos/iot.
| Tipo: | String[] |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IgnoreFirstRecord
Se definido como true, indica que a ingestão deve ignorar o primeiro registro de cada arquivo.
| Tipo: | SwitchParameter |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IotHubResourceId
O ID do recurso do hub Iot a ser usado para criar uma conexão de dados.
| Tipo: | String |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Kind
Tipo de ponto de extremidade para a conexão de dados
| Tipo: | DataConnectionKind |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-KustoPoolName
O nome do pool Kusto.
| Tipo: | String |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Location
Localização do recurso.
| Tipo: | String |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MappingRuleName
A regra de mapeamento a ser usada para ingerir os dados. Opcionalmente, as informações de mapeamento podem ser adicionadas a cada mensagem.
| Tipo: | String |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NoWait
Execute o comando de forma assíncrona
| Tipo: | SwitchParameter |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ResourceGroupName
O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
| Tipo: | String |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SharedAccessPolicyName
O nome da política de acesso de compartilhamento.
| Tipo: | String |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StorageAccountResourceId
O ID do recurso da conta de armazenamento onde os dados residem.
| Tipo: | String |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SubscriptionId
A ID da assinatura de destino.
| Tipo: | String |
| Position: | Named |
| valor predefinido: | (Get-AzContext).Subscription.Id |
| Necessário: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TableName
A tabela onde os dados devem ser ingeridos. Opcionalmente, as informações da tabela podem ser adicionadas a cada mensagem.
| Tipo: | String |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.
| Tipo: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WorkspaceName
O nome do espaço de trabalho
| Tipo: | String |
| Position: | Named |
| valor predefinido: | None |
| Necessário: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entradas
Saídas
Azure PowerShell
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários