Compartir a través de

Comando .ingest insert (inserción)

  • Artículo

Se aplica a: ✅Microsoft Fabric✅Azure Data Explorer

Este comando inserta datos en una tabla insertando los datos incluidos en el comando en la tabla.

Nota:

Este método de ingesta está diseñado para la exploración y la creación de prototipos. No lo use en escenarios de producción o de gran volumen.

Permisos

Debe tener al menos permisos de ingeror de tabla para ejecutar este comando.

Sintaxis

.ingestinline into table TableName [with ( IngestionPropertyName = IngestionPropertyValue [, ...] ] <| )Datos

.ingestinline into table TableName [with ( IngestionPropertyName = IngestionPropertyValue [, ...] ] [ )Datos ]

Obtenga más información sobre las convenciones de sintaxis.

Parámetros

Nombre Type Obligatorio Descripción
TableName string ✔️ Nombre de la tabla en la que se van a ingerir datos. El nombre de la tabla siempre es relativo a la base de datos en contexto y su esquema es el esquema que se asumirá para los datos si no se proporciona ningún objeto de asignación de esquemas.
Data string ✔️ Contenido de datos que se va a ingerir. A menos que las propiedades de ingesta modifiquen lo contrario, este contenido se analiza como CSV.
IngestionPropertyName, IngestionPropertyValue string Cualquier número de propiedades de ingesta que afecten al proceso de ingesta.

Nota:

A diferencia de la mayoría de los comandos y consultas de administración, el texto de la parte Datos del comando no tiene que seguir las convenciones sintácticas del lenguaje. Por ejemplo, los caracteres de espacio en blanco son importantes o la // combinación no se trata como comentario.

Devoluciones

El resultado es una tabla con tantos registros como el número de particiones de datos generadas ("extensiones"). Si no se generan particiones de datos, se devuelve un único registro con un identificador de extensión vacío (con valores cero).

Nombre Escribir Descripción
ExtentId guid Identificador único de la partición de datos generada por el comando

Ejemplos

Ingesta con <| sintaxis

El siguiente comando ingiere datos en una tabla Purchases con dos columnas: SKU (de tipo string) y Quantity (de tipo long).

.ingest inline into table Purchases <|
    Shoes,1000
    Wide Shoes,50
    "Coats black",20
    "Coats with ""quotes""",5

Ingesta con sintaxis de corchetes

El siguiente comando ingiere datos en una tabla Logs con dos columnas: Date (de tipo datetime) y EventDetails (de tipo dynamic).

.ingest inline into table Logs
    [2015-01-01,"{""EventType"":""Read"", ""Count"":""12""}"]
    [2015-01-01,"{""EventType"":""Write"", ""EventValue"":""84""}"]

Contenido relacionado