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 se ponen a disposición para su consulta en el Explorador de datos. Agrega propiedades al comando de ingesta después de la palabra clave with.

Propiedades de ingesta

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

Propiedad Descripción Ejemplo
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 asignación pertinente. 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 pertinente. Vea Asignaciones de datos. with (format="csv", ingestionMappingReference = "Mapping1")
(en desuso: avroMappingReference, csvMappingReference, jsonMappingReference)
creationTime Valor de fecha y hora (formateado como una cadena ISO8601) que se usará en el momento de creación de las extensiones de datos ingeridas. 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 Lookback en la directiva de combinación de extensiones efectiva 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 En el caso de los comandos de ingesta desde consulta, 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 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 etiqueta ingest-by: con el mismo valor. Esto garantiza la ingesta de datos idempotente. Para obtener más información, consulte ingest-by: etiquetas. 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 ingesta debe omitir el primer registro de cada archivo. Esta propiedad es útil para los archivos en CSVy formatos similares, si el primer registro del archivo son los nombres de columna. De forma predeterminada, se supone false. 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 debe habilitar la directiva de tiempo de ingesta de 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 comando .set-or-replace. Esta propiedad tiene prioridad sobre la propiedad extend_schema si se establecen ambas. with (recreate_schema=true)
tags Una lista de etiquetas para asociar a los datos ingeridos, formateada como una cadena JSON with (tags="['Tag1', 'Tag2']")
validationPolicy Cadena JSON que indica qué validaciones se van a ejecutar durante la ingesta. Consulte la 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