New-AzKustoDataConnection
Crea o actualiza una conexión de datos.
Sintaxis
New-AzKustoDataConnection
-ClusterName <String>
-DatabaseName <String>
-Name <String>
-ResourceGroupName <String>
[-SubscriptionId <String>]
-Kind <Kind>
-Location <String>
[-TableName <String>]
-EventHubResourceId <String>
-ConsumerGroup <String>
[-DataFormat <String>]
[-EventSystemProperty <String[]>]
[-MappingRuleName <String>]
[-Compression <Compression>]
[-ManagedIdentityResourceId <String>]
[-DatabaseRouting <DatabaseRouting>]
[-RetrievalStartDate <DateTime>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzKustoDataConnection
-ClusterName <String>
-DatabaseName <String>
-Name <String>
-ResourceGroupName <String>
[-SubscriptionId <String>]
-Kind <Kind>
-Location <String>
[-TableName <String>]
-EventHubResourceId <String>
-ConsumerGroup <String>
[-DataFormat <String>]
[-MappingRuleName <String>]
[-ManagedIdentityResourceId <String>]
[-DatabaseRouting <DatabaseRouting>]
-StorageAccountResourceId <String>
[-BlobStorageEventType <BlobStorageEventType>]
[-IgnoreFirstRecord]
[-EventGridResourceId <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzKustoDataConnection
-ClusterName <String>
-DatabaseName <String>
-Name <String>
-ResourceGroupName <String>
[-SubscriptionId <String>]
-Kind <Kind>
-Location <String>
[-TableName <String>]
-ConsumerGroup <String>
[-DataFormat <String>]
[-EventSystemProperty <String[]>]
[-MappingRuleName <String>]
[-DatabaseRouting <DatabaseRouting>]
[-RetrievalStartDate <DateTime>]
-IotHubResourceId <String>
-SharedAccessPolicyName <String>
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzKustoDataConnection
-ClusterName <String>
-DatabaseName <String>
-Name <String>
-ResourceGroupName <String>
[-SubscriptionId <String>]
-Kind <Kind>
-Location <String>
[-TableName <String>]
[-MappingRuleName <String>]
-ManagedIdentityResourceId <String>
[-RetrievalStartDate <DateTime>]
-CosmosDbAccountResourceId <String>
-CosmosDbDatabase <String>
-CosmosDbContainer <String>
[-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-AzKustoDataConnection -ResourceGroupName "testrg" -ClusterName "testnewkustocluster" -DatabaseName "mykustodatabase" -DataConnectionName "myeventhubdc" -Location "East US" -Kind "EventHub" -EventHubResourceId "/subscriptions/$subscriptionId/resourcegroups/testrg/providers/Microsoft.EventHub/namespaces/myeventhubns/eventhubs/myeventhub" -DataFormat "JSON" -ConsumerGroup '$Default' -Compression "None" -TableName "Events" -MappingRuleName "EventsMapping"
Kind Location Name Type
---- -------- ---- ----
EventHub East US testnewkustocluster/mykustodatabase/myeventhubdc Microsoft.Kusto/Clusters/Databases/DataConnectionsEl comando anterior crea una nueva conexión de datos de EventHub denominada "myeventhubdc" para la base de datos "mykustodatabase" en el clúster "testnewkustocluster".
Ejemplo 2: Creación de una nueva conexión de datos de EventGrid
New-AzKustoDataConnection -ResourceGroupName "testrg" -ClusterName "testnewkustocluster" -DatabaseName "mykustodatabase" -DataConnectionName "myeventgriddc" -Location "East US" -Kind "EventGrid" -EventHubResourceId "/subscriptions/$subscriptionId/resourcegroups/testrg/providers/Microsoft.EventHub/namespaces/myeventhubns/eventhubs/myeventhub" -StorageAccountResourceId "/subscriptions/$subscriptionId/resourcegroups/testrg/providers/Microsoft.Storage/storageAccounts/mystorage" -DataFormat "JSON" -ConsumerGroup '$Default' -TableName "Events" -MappingRuleName "EventsMapping"
Kind Location Name Type
---- -------- ---- ----
EventGrid East US testnewkustocluster/mykustodatabase/myeventgriddc Microsoft.Kusto/Clusters/Databases/DataConnectionsEl comando anterior crea una nueva conexión de datos de EventGrid denominada "myeventgriddc" para la base de datos "mykustodatabase" en el clúster "testnewkustocluster".
Ejemplo 3: Creación de una nueva conexión de datos de IotHub
New-AzKustoDataConnection -ResourceGroupName "testrg" -ClusterName "testnewkustocluster" -DatabaseName "mykustodatabase" -DataConnectionName "myiothubdc" -Location "East US" -Kind "IotHub" -IotHubResourceId "/subscriptions/$subscriptionId/resourcegroups/testrg/providers/Microsoft.Devices/IotHubs/myiothub" -SharedAccessPolicyName "myiothubpolicy" -DataFormat "JSON" -ConsumerGroup '$Default' -TableName "Events" -MappingRuleName "EventsMapping"
Kind Location Name Type
---- -------- ---- ----
IotHub East US testnewkustocluster/mykustodatabase/myiothubdc Microsoft.Kusto/Clusters/Databases/DataConnectionsEl comando anterior crea una nueva conexión de datos de IotHub denominada "myiothubdc" para la base de datos "mykustodatabase" en el clúster "testnewkustocluster".
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 |
-ClusterName
Nombre del clúster de Kusto.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| 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 solicita su 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 |
-CosmosDbAccountResourceId
Identificador de recurso de la cuenta de Cosmos DB que se usa para crear la 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 |
-CosmosDbContainer
Nombre de un contenedor existente en la base de datos de Cosmos DB.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-CosmosDbDatabase
Nombre de una base de datos existente en la cuenta de Cosmos DB.
| 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 en el clúster de Kusto.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-DatabaseRouting
Indicación de la información de enrutamiento de base de datos de la conexión de datos, de forma predeterminada solo se permite la información de enrutamiento de base de datos.
| Tipo: | DatabaseRouting |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| 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: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-DefaultProfile
Credenciales, cuenta, inquilino y suscripción usados 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 |
-EventGridResourceId
Identificador de recurso de la cuadrícula de eventos que se suscribe a los eventos de la cuenta de almacenamiento.
| Tipo: | String |
| 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: | Kind |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Location
Ubicación de recursos.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-ManagedIdentityResourceId
Identificador de recurso de una identidad administrada (sistema o usuario asignado) que se usará para autenticarse con recursos externos.
| 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 |
-Name
Nombre de la conexión de datos.
| Tipo: | String |
| Alias: | DataConnectionName |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| 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 que contiene el clúster de Kusto.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-RetrievalStartDate
Cuando se define, la conexión de datos recupera los eventos existentes del centro de eventos creados desde la fecha de inicio de recuperación. Solo puede recuperar eventos retenidos por el centro de eventos, en función de su período de retención.
| Tipo: | DateTime |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| 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
Obtiene las credenciales de suscripción que identifican de forma única la suscripción de Microsoft Azure. El identificador de suscripción forma parte del URI para cada llamada al servicio.
| 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 se ejecutara el cmdlet. 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 |
Salidas
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de