CreateDataImportOrder - - Centro de documentación de Alibaba Cloud

Crea un ticket para importar datos a Data Management (DMS).

Para obtener más información sobre la función Large Data Import, consulte Importar datos.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para mayor comodidad, le recomendamos ejecutar esta operación en OpenAPI Explorer. Esta herramienta genera dinámicamente el código de ejemplo de la operación para distintos SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	CreateDataImportOrder	La operación que desea ejecutar. Establezca el valor en CreateDataImportOrder.
Comment	String	Sí	test	El propósito u objetivo de la importación de datos. Este parámetro ayuda a reducir la comunicación innecesaria.
RelatedUserList	Array of Long	No	51****	Los interesados en la importación de datos. Todos ellos pueden consultar los detalles del ticket y colaborar en el proceso de aprobación. Los usuarios no relacionados, excepto los administradores de DMS y los administradores de bases de datos (DBA), no tienen permiso para ver estos detalles.
Param	Object	Sí		Los parámetros del ticket.
Classify	String	No	test	El motivo de la importación de datos.
AttachmentName	String	Sí	order_text	La clave del archivo adjunto que contiene las instrucciones SQL utilizadas para importar datos. Llame a la operación GetUserUploadFileJob para obtener la clave del archivo adjunto a partir del valor del parámetro AttachmentKey.
DbItemList	Array	Sí		La base de datos de destino para la importación. Solo puede especificar una base de datos.
DbId	Long	Sí	1860****	El ID de la base de datos. Puede tratarse de una base de datos física o lógica. Para obtener el ID de una base de datos física, llame a la operación ListDatabases o SearchDatabase. Para obtener el ID de una base de datos lógica, llame a la operación ListLogicDatabases o SearchDatabase.
Logic	Boolean	Sí	false	Indica si la base de datos es lógica. Valores válidos: true: la base de datos es lógica. false: la base de datos es física. Nota Si establece este parámetro en true, la base de datos que especifique debe ser lógica.
FileType	String	Sí	CSV	El formato del archivo para la importación de datos. Valores válidos: SQL: archivo SQL CSV: archivo CSV
FileEncoding	String	No	AUTO	El algoritmo de codificación que utilizará la base de datos de destino. Valores válidos: AUTO: identificación automática UTF-8: codificación UTF-8 GBK: codificación GBK ISO-8859-1: codificación ISO-8859-1
TableName	String	No	Table_text	La tabla de destino donde se importarán los datos en formato CSV. Nota Este parámetro es obligatorio si establece el parámetro FileType en CSV.
InsertType	String	No	INSERT	El modo en el que se escribirán los datos en formato CSV en la tabla de destino. Valores válidos: INSERT: la base de datos comprueba la clave principal al escribir los datos. Si existe un valor de clave principal duplicado, devuelve un mensaje de error. INSERT_IGNORE: si los datos importados contienen registros idénticos a los de la tabla de destino, los registros nuevos se ignoran. REPLACE_INTO: si los datos importados contienen una fila con el mismo valor de clave principal o índice único que una fila de la tabla de destino, la base de datos elimina la fila existente e inserta la nueva. Nota Este parámetro es obligatorio si establece el parámetro FileType en CSV.
CsvFirstRowIsColumnDef	Boolean	No	true	El tipo de archivo CSV. Valores válidos: true: la primera fila del archivo CSV contiene los nombres de los campos. false: la primera fila del archivo CSV contiene datos. Nota Este parámetro es obligatorio si establece el parámetro FileType en CSV.
IgnoreError	Boolean	No	false	Indica si se omite un error cuando ocurre. Valores válidos: true: omite el error y continúa ejecutando las instrucciones SQL. false: detiene la ejecución de las instrucciones SQL.
ImportMode	String	No	FAST_MODE	El modo de importación. Valores válidos: FAST_MODE: en el paso Execute, se lee el archivo cargado y se ejecutan instrucciones SQL para importar los datos a la base de datos de destino especificada. En comparación con el modo seguro, este método importa datos de forma menos segura pero más eficiente. SAFE_MODE: en el paso Precheck, se analiza sintácticamente el archivo cargado y se almacenan en caché las instrucciones SQL o los datos del archivo CSV. En el paso Execute, se leen y ejecutan las instrucciones SQL almacenadas en caché para importar los datos, o bien se leen los datos CSV en caché y se importan a la base de datos de destino especificada. Este método importa datos de forma más segura pero menos eficiente.
RollbackSQL	String	No	empty	Las instrucciones SQL utilizadas para revertir la importación de datos. Nota Este parámetro es obligatorio si establece el parámetro RollbackSqlType en TEXT.
RollbackAttachmentName	String	No	rollback.sql	La clave del archivo adjunto que contiene las instrucciones SQL utilizadas para revertir la importación de datos. Llame a la operación GetUserUploadFileJob para obtener la clave del archivo adjunto a partir del valor del parámetro AttachmentKey. Nota Este parámetro es obligatorio si establece el parámetro RollbackSqlType en ATTACHMENT.
RollbackSqlType	String	No	TEXT	El formato de las instrucciones SQL utilizadas para revertir la importación de datos. Valores válidos: TEXT: texto ATTACHMENT: archivo adjunto
AttachmentKey	String	No	order_attachment.txt	La clave del archivo adjunto que proporciona más instrucciones para el ticket. Llame a la operación GetUserUploadFileJob para obtener la clave del archivo adjunto a partir del valor del parámetro AttachmentKey.
Tid	Long	No	3***	El ID del inquilino. Llame a la operación GetUserActiveTenant o ListUserTenants para obtenerlo.
RegionId	String	No	cn-hangzhou	El ID de la región donde se activó DMS. Para obtener más información, consulte Parámetro RegionID.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	0C1CB646-1DE4-4AD0-B4A4-7D47DD52E931	El ID de la solicitud.
Success	Boolean	true	Indica si la solicitud se completó correctamente. Valores válidos: true: la solicitud se completó correctamente. false: la solicitud falló.
ErrorMessage	String	UnknownError	El mensaje de error devuelto si la solicitud falla.
ErrorCode	String	UnknownError	El código de error devuelto si la solicitud falla.
CreateOrderResult	Array of Long	1****	El ID del ticket.

Ejemplos

Ejemplos de solicitudes

http(s)://dms-enterprise.aliyuncs.com/?Action=test
&Comment=test
&RelatedUserList=[51****]
&Param={"Classify":"test","AttachmentName":"order_text","DbItemList":[{"DbId":1860****,"Logic":false}],"FileType":"CSV","FileEncoding":"AUTO","TableName":"Table_text","InsertType":"INSERT","CsvFirstRowIsColumnDef":true,"IgnoreError":false,"ImportMode":"FAST_MODE"}
&AttachmentKey=order_attachment.txt
&<Common request parameters>

Ejemplos de respuestas exitosas

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateDataImportOrderResponse>
    <RequestId>0C1CB646-1DE4-4AD0-B4A4-7D47DD52E931</RequestId>
    <Success>true</Success>
    <CreateOrderResult>1****</CreateOrderResult>
</CreateDataImportOrderResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "0C1CB646-1DE4-4AD0-B4A4-7D47DD52E931",
  "Success" : true,
  "CreateOrderResult" : [ "1****" ]
}

Códigos de error

Para consultar la lista de códigos de error, visite el centro de errores de API.