Configuración de Azure Cosmos DB for NoSQL en una actividad de copia

En este artículo se describe cómo usar la actividad de copia en una canalización de datos para copiar datos desde y hacia Azure Cosmos DB for NoSQL.

Configuración admitida

Para la configuración de cada pestaña en la actividad de copia, vaya a las secciones siguientes respectivamente.

• General
• Origen
• Destino
• Asignación
• Configuración

General

Consulte las instruccionesgenerales para configurar la pestaña de parámetros General.

Origen

Las siguientes propiedades son compatibles con Azure Cosmos DB for NoSQL en la pestaña Origen de una actividad de copia.

Se requieren las siguientes tres propiedades:

• Tipo de banco de datos : seleccione Externo.
• Conexión: seleccione una conexión de Azure Cosmos DB for NoSQL en la lista de conexiones. Si no existe ninguna conexión, cree una nueva conexión de Azure Cosmos DB for NoSQL seleccionando Nuevo.
• Contenedor: seleccione el contenedor que quiere usar. Seleccione Editar para escribir manualmente el nombre del contenedor.

En Avanzado, puede especificar los campos siguientes:

• Usar consulta: puede elegir Tabla o Consulta como consulta de uso. La siguiente lista describe la configuración de cada opción.

  • Tabla: lee los datos de la tabla especificada en Tabla.

  • Consulta: especifica la consulta de Azure Cosmos DB para leer datos.

    

• Tamaño de página: número de documentos por página del resultado de la consulta. El valor predeterminado es "-1", lo que significa usar el tamaño de página dinámica del servicio hasta 1000.

• Detectar datetime: determina si se debe detectar datetime a partir de los valores de cadena de los documentos. Los valores permitidos son: True (valor predeterminado) y False.

• Regiones preferidas: lista preferida de regiones a las que se conectará cuando recupere los datos de Azure Cosmos DB. Seleccione una región preferida en la lista desplegable después de seleccionar Nuevo.

  

• Columnas adicionales: añada columnas de datos adicionales para almacenar la ruta relativa o el valor estático de los archivos de origen. La expresión se admite para este último. Para más información, vaya a Agregar columnas adicionales durante la copia.

  

Destination

Las siguientes propiedades son compatibles con Azure Cosmos DB for NoSQL en la pestaña Destino de una actividad de copia.

Se requieren las siguientes tres propiedades:

• Tipo de banco de datos : seleccione Externo.
• Conexión: seleccione una conexión de Azure Cosmos DB for NoSQL en la lista de conexiones.
• Contenedor: seleccione Examinar para elegir el archivo que desea copiar o rellene la ruta manualmente.

En Avanzado, puede especificar los campos siguientes:

• Comportamiento de escritura: define el comportamiento de escritura cuando el destino son archivos de un almacén de datos basado en archivos. Puede elegir Agregar contenido dinámico, Insertar o Upsert en la lista desplegable.

  • Agregar contenido dinámico: abra el panel Agregar contenido dinámico. Así se abre el generador de expresiones, donde puede compilar expresiones a partir de variables del sistema admitidas, salidas de actividad, funciones y variables o parámetros especificados por el usuario. Para más información sobre el lenguaje de expresiones, vaya a Expresiones y funciones.

  • Insertar: elija esta opción si los datos de origen tienen inserciones.

  • Upsert: el comportamiento de upsert consiste en reemplazar el documento si ya existe un documento con el mismo identificador; en caso contrario, inserta el documento.

    

• Tiempo de espera de escritura por lotes: tiempo de espera para que la operación de inserción por lotes se complete antes de que se agote el tiempo de espera. Los valores permitidos son Timespan. Un ejemplo es 00:30:00 (30 minutos).

• Tamaño del lote de escritura: especifique el número de filas a insertar en la tabla SQL por lote. El valor permitido es un entero (número de filas). De manera predeterminada, el servicio determina dinámicamente el tamaño adecuado del lote en función del tamaño de fila.

• Máximo de conexiones simultáneas: límite superior de conexiones simultáneas establecidas con el almacén de datos durante la ejecución de la actividad. Especifique un valor solo cuando quiera limitar las conexiones simultáneas.

• Deshabilitar el análisis de métricas de rendimiento: la configuración controla la recopilación de métricas, como DTU, DWU, RU, etc., para la optimización del rendimiento de la copia y las recomendaciones. Si le preocupa este comportamiento, desactive esta característica.

Asignación

Para la configuración de la pestañaAsignación, vaya a Configurar las asignaciones en la ficha Asignación .

Configuración

Para la configuración de la pestaña Parámetros, vaya a Configurar los otros parámetros en parámetros de pestaña.

Resumen de tabla

Las tablas siguientes contienen más información sobre la actividad de copia en Azure Cosmos DB for NoSQL.

Tabla de origen

Nombre	Descripción	Value	Obligatorio	Propiedad de script JSON
Tipo de almacén de datos	El tipo de almacén de datos.	Externo	Sí	/
Connection	La conexión al almacén de datos de origen.	<su conexión>	Sí	conexión
Contenedor	Contenedor de los datos de origen.	<contenedor del origen>	Sí	contenedor fileName
Usar consulta	Puede elegir Tabla o Consulta como consulta de uso.	• Tabla • Consulta	No	type
Tamaño de página	Número de documentos por página del resultado de la consulta. El valor predeterminado es "-1", lo que significa usar el tamaño de página dinámica del servicio hasta 1000.	<el tamaño de página>	No	pageSize
Eliminar datetime	Los archivos del almacén de datos de origen se eliminarán justo después de moverse al almacén de destino. La eliminación del archivo es por archivo, por lo que cuando falla una actividad de copia, observará que algunos archivos ya se han copiado al destino y eliminado del origen, mientras que otros siguen en el almacén de origen.	Selección o anulación de selección	No	detectDatetime
Regiones preferidas	Lista preferida de regiones a las que se conectará cuando recupere los datos de Azure Cosmos DB. Seleccione una región preferida en la lista desplegable después de seleccionar Nuevo.	<sus regiones preferidas>	No	preferredRegions
Columnas adicionales	Agregue columnas de datos adicionales para almacenar la ruta de acceso relativa o el valor estático de los archivos de origen. La expresión se admite para este último. Para más información, vaya a Agregar columnas adicionales durante la copia.	< número máximo de conexiones simultáneas >	No	additionalColumns

Tabla de destino

Nombre	Descripción	Value	Obligatorio	Propiedad de script JSON
Tipo de almacén de datos	El tipo de almacén de datos.	Externo	Sí	/
Connection	La conexión al almacén de datos de destino.	<su conexión>	Sí	conexión
Contenedor	Contenedor de los datos de destino.	<contenedor de origen>	Sí	contenedor fileName
Comportamiento de escritura	Describe cómo escribir datos en Azure Cosmos DB. Valores permitidos: insert y upsert. El comportamiento de upsert consiste en reemplazar el documento si ya existe un documento con el mismo identificador; en caso contrario, inserta el documento.	• Agregar contenido dinámico • Insertar • Upsert	No	writeBehavior
Tiempo de espera de escritura por lotes	Tiempo de espera para que la operación de inserción por lotes se complete antes de que se agote el tiempo de espera. Los valores permitidos son intervalos de tiempo. Un ejemplo es 00:30:00 (30 minutos).	timespan	No	writeBatchTimeout
Tamaño del lote de escritura	Número de filas que se va a insertar en la tabla SQL por lote. El valor que se permite es un entero (número de filas). De manera predeterminada, el servicio determina dinámicamente el tamaño adecuado del lote en función del tamaño de fila.	<número de filas > (entero)	No	writeBatchSize
Número máximo de conexiones simultáneas	Número máximo de conexiones simultáneas establecidas en el almacén de datos durante la ejecución de la actividad. Especifique un valor solo cuando quiera limitar las conexiones simultáneas.	< número máximo de conexiones simultáneas >	No	maxConcurrentConnections
Desactivar análisis de métricas de rendimiento	Esta configuración controla la recopilación de métricas como DTU, DWU, RU, etc. para la optimización del rendimiento de la copia y las recomendaciones. Si le preocupa este comportamiento, desactive esta característica.	Selección o anulación de selección	No	disableMetricsCollection

Contenido relacionado

• Configuración de la conexión de Azure Cosmos DB for NoSQL