Compartir a través de

Propiedades de ingesta de datos de Azure Synapse Data Explorer (versión preliminar)

Importante

El Explorador de datos de Azure Synapse Analytics (versión preliminar) se retirará el 7 de octubre de 2025. Después de esta fecha, se eliminarán las cargas de trabajo que se ejecutan en el Explorador de datos de Synapse y se perderán los datos de la aplicación asociados. Se recomienda migrar a Eventhouse en Microsoft Fabric.

El programa Microsoft Cloud Migration Factory (CMF) está diseñado para ayudar a los clientes a migrar a Fabric. El programa ofrece recursos de teclado prácticos sin costo alguno al cliente. Estos recursos se asignan durante un período de 6 a 8 semanas, con un ámbito predefinido y acordado. Las nominaciones de clientes se aceptan por parte del equipo de la cuenta de Microsoft o directamente enviando una solicitud de ayuda al equipo de CMF.

La ingesta de datos es el proceso por el que se agregan datos a una tabla y están disponibles para la consulta en el Explorador de datos. Agregue propiedades al comando de ingesta después de la with clave.

Propiedades de ingesta

En la tabla siguiente se enumeran las propiedades admitidas por el Explorador de datos, se describen y se proporcionan ejemplos:

Propiedad Description Example
ingestionMapping Valor de cadena que indica cómo asignar datos del archivo de origen a las columnas reales de la tabla. Defina el valor format con el tipo de asociación correspondiente. Vea Asignaciones de datos. with (format="json", ingestionMapping = "[{\"column\":\"rownumber\", \"Properties\":{\"Path\":\"$.RowNumber\"}}, {\"column\":\"rowguid\", \"Properties\":{\"Path\":\"$.RowGuid\"}}]")
(en desuso: avroMapping, csvMapping, jsonMapping)
ingestionMappingReference Valor de cadena que indica cómo asignar datos del archivo de origen a las columnas reales de la tabla mediante un objeto de directiva de asignación con nombre. Defina el valor format con el tipo de asignación correspondiente. Vea Asignaciones de datos. with (format="csv", ingestionMappingReference = "Mapping1")
(en desuso: avroMappingReference, csvMappingReference, jsonMappingReference)
creationTime Valor datetime (con formato de cadena en ISO8601) que se usará en el momento de la creación de las extensiones de datos a ingerir. Si no se especifica, se usará el valor actual (now()). Invalidar el valor predeterminado es útil al ingerir datos más antiguos para que la directiva de retención se aplique correctamente. Cuando se especifique, asegúrese de que la propiedad de la política de combinación de "Extents" efectivos de la tabla de destino esté alineada con el valor especificado. with (creationTime="2017-02-13")
extend_schema Valor booleano que, si se especifica, indica al comando que extienda el esquema de la tabla (el valor predeterminado es false). Esta opción solo se aplica a los comandos .append y .set-or-append. Las únicas extensiones de esquema permitidas tienen columnas adicionales agregadas a la tabla al final. Si el esquema de tabla original es (a:string, b:int), una extensión de esquema válida sería (a:string, b:int, c:datetime, d:string), pero (a:string, c:datetime) no sería válida.
folder Para los comandos ingest-from-query , la carpeta que se va a asignar a la tabla. Si la tabla ya existe, esta propiedad invalidará la carpeta de la tabla. with (folder="Tables/Temporary")
format El formato de datos (consulte los formatos de datos admitidos). with (format="csv")
ingestIfNotExists Valor de cadena que, si se especifica, impide que la ingesta se realice correctamente si la tabla ya tiene datos etiquetados con una ingest-by: etiqueta con el mismo valor. Esto garantiza la ingesta de datos idempotentes. Para obtener más información, consulte ingest-by: tags. Las propiedades with (ingestIfNotExists='["Part0001"]', tags='["ingest-by:Part0001"]') indican que si ya existen datos con la etiqueta ingest-by:Part0001 , no complete la ingesta actual. Si aún no existe, esta nueva ingesta debe tener establecida esta etiqueta (en caso de que una ingesta futura intente volver a ingerir los mismos datos).
ignoreFirstRecord Valor booleano que, si se establece en true, indica que la ingestión debe omitir el primer registro de cada archivo. Esta propiedad es útil para los archivos en CSV y formatos similares, si el primer registro del archivo son los nombres de las columnas. De forma predeterminada, false se supone. with (ignoreFirstRecord=false)
persistDetails Valor booleano que, si se especifica, indica que el comando debe conservar los resultados detallados (incluso si se ejecuta correctamente) para que el comando .show operation details pueda recuperarlos. Tiene como valor predeterminado false. with (persistDetails=true)
policy_ingestiontime Valor booleano que, si se especifica, describe si se va a habilitar la directiva de tiempo de ingesta en una tabla creada por este comando. El valor predeterminado es true. with (policy_ingestiontime=false)
recreate_schema Valor booleano que, si se especifica, describe si el comando puede volver a crear el esquema de la tabla. Esta propiedad solo se aplica al .set-or-replace comando . Esta propiedad tiene prioridad sobre la propiedad extend_schema si se establecen ambos. with (recreate_schema=true)
tags Lista de etiquetas que se van a asociar a los datos ingeridos, con formato de cadena JSON with (tags="['Tag1', 'Tag2']")
validationPolicy Cadena JSON que indica qué validaciones se van a ejecutar durante la ingesta. Consulte Ingesta de datos para obtener una explicación de las distintas opciones. with (validationPolicy='{"ValidationOptions":1, "ValidationImplications":1}') (esto es realmente la directiva predeterminada)
zipPattern Use esta propiedad al ingerir datos del almacenamiento que tiene un archivo ZIP. Se trata de un valor de cadena que indica la expresión regular que se va a usar al seleccionar los archivos del archivo ZIP que se van a ingerir. Se omitirán todos los demás archivos del archivo. with (zipPattern="*.csv")

Pasos siguientes

  • Last updated on