New-AzSynapseKustoPoolDataConnection

Referencia

Módulo:: Az.Synapse

Crea o actualiza una conexión de datos.

Sintaxis

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

Crea o actualiza una conexión de datos.

Ejemplos

Ejemplo 1: Creación de una nueva conexión de datos de 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

El comando anterior crea una nueva conexión de datos de EventHub denominada "eventhubdc" para la base de datos "testdatabase" en el grupo de kusto "testkustopool".

Ejemplo 2: Creación de una nueva conexión de datos de 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

El comando anterior crea una nueva conexión de datos de EventGrid denominada "eventgriddc" para la base de datos "testdatabase" en el grupo de kusto "testkustopool".

Ejemplo 3: Creación de una nueva conexión de datos de 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

El comando anterior crea una nueva conexión de datos de IotHub denominada "iothubdc" para la base de datos "testdatabase" en el grupo de kusto "testkustopool".

Parámetros

-AsJob

Ejecución del comando como trabajo

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-BlobStorageEventType

Nombre del tipo de evento de Blob Storage que se va a procesar.

Tipo:	BlobStorageEventType
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Compression

Tipo de compresión de mensajes del centro de eventos.

Tipo:	Compression
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ConsumerGroup

El grupo de consumidores de event/iot hub.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DatabaseName

Nombre de la base de datos del grupo de Kusto.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DataConnectionName

Nombre de la conexión de datos.

Tipo:	String
Alias:	Name
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DataFormat

Formato de datos del mensaje. Opcionalmente, el formato de datos se puede agregar a cada mensaje.

Tipo:	EventGridDataFormat
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Tipo:	PSObject
Alias:	AzureRMContext, AzureCredential
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-EventHubResourceId

El identificador de recurso del centro de eventos que se va a usar para crear una conexión de datos o Event Grid está configurado para enviar eventos.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-EventSystemProperty

Propiedades del sistema del centro de eventos/iot.

Tipo:	String[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-IgnoreFirstRecord

Si se establece en true, indica que la ingesta debe omitir el primer registro de cada archivo.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-IotHubResourceId

Identificador de recurso del centro de IoT que se va a usar para crear una conexión de datos.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Kind

Tipo de punto de conexión para la conexión de datos

Tipo:	DataConnectionKind
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-KustoPoolName

Nombre del grupo de Kusto.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Location

Ubicación del recurso.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-MappingRuleName

Regla de asignación que se va a usar para ingerir los datos. Opcionalmente, la información de asignación se puede agregar a cada mensaje.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-NoWait

Ejecutar el comando de forma asincrónica

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ResourceGroupName

Nombre del grupo de recursos. El nombre no distingue mayúsculas de minúsculas.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-SharedAccessPolicyName

Nombre de la directiva de acceso a recursos compartidos.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-StorageAccountResourceId

Identificador de recurso de la cuenta de almacenamiento donde residen los datos.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-SubscriptionId

Identificador de la suscripción de destino.

Tipo:	String
Posición:	Named
Valor predeterminado:	(Get-AzContext).Subscription.Id
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-TableName

Tabla donde se deben ingerir los datos. Opcionalmente, la información de la tabla se puede agregar a cada mensaje.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Tipo:	SwitchParameter
Alias:	wi
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-WorkspaceName

Nombre del área de trabajo

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

IDataConnection

Salidas