CreateDataImportOrder - : Central de Documentação do Alibaba Cloud

Para obter mais informações sobre o recurso de importação de grandes volumes de dados, consulte Importar dados.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	CreateDataImportOrder	A operação a ser executada. Defina o valor como CreateDataImportOrder.
Comment	String	Sim	test	Finalidade ou objetivo da importação de dados. Este parâmetro ajuda a reduzir comunicações desnecessárias.
RelatedUserList	Array of Long	Não	51****	Partes interessadas na importação de dados. Todos os envolvidos podem visualizar os detalhes do ticket e auxiliar no processo de aprovação. Usuários não relevantes, exceto administradores do DMS e administradores de banco de dados (DBAs), não têm permissão para visualizar esses detalhes.
Param	Object	Sim		Parâmetros do ticket.
Classify	String	Não	test	Motivo da importação de dados.
AttachmentName	String	Sim	order_text	Chave do anexo com as instruções SQL para importar dados. Chame a operação GetUserUploadFileJob para obter essa chave a partir do valor do parâmetro AttachmentKey.
DbItemList	Array	Sim		Banco de dados de destino da importação. Especifique apenas um banco de dados.
DbId	Long	Sim	1860****	ID do banco de dados, que pode ser físico ou lógico. Para obter o ID de um banco de dados físico, chame a operação ListDatabases ou SearchDatabase. Para obter o ID de um banco de dados lógico, chame a operação ListLogicDatabases ou SearchDatabase.
Logic	Boolean	Sim	false	Indica se o banco de dados é lógico. Valores válidos: true: O banco de dados é lógico. false: O banco de dados é físico. Nota Se você definir este parâmetro como true, especifique um banco de dados lógico.
FileType	String	Sim	CSV	Formato do arquivo para importação de dados. Valores válidos: SQL: arquivo SQL CSV: arquivo CSV
FileEncoding	String	Não	AUTO	Algoritmo de codificação do banco de dados de destino. Valores válidos: AUTO: identificação automática UTF-8: codificação UTF-8 GBK: codificação GBK ISO-8859-1: codificação ISO-8859-1
TableName	String	Não	Table_text	Tabela de destino para importar os dados em formato CSV. Nota Este parâmetro é obrigatório se o parâmetro FileType for definido como CSV.
InsertType	String	Não	INSERT	Modo de gravação dos dados CSV na tabela de destino. Valores válidos: INSERT: O banco de dados verifica a chave primária durante a gravação. Se houver duplicidade, o sistema retornará uma mensagem de erro. INSERT_IGNORE: Ignora novos registros caso os dados importados contenham entradas idênticas às da tabela de destino. REPLACE_INTO: Substitui a linha existente e insere a nova linha na tabela de destino caso os dados importados contenham uma linha com o mesmo valor de chave primária ou índice exclusivo. Nota Este parâmetro é obrigatório se o parâmetro FileType for definido como CSV.
CsvFirstRowIsColumnDef	Boolean	Não	true	Tipo do arquivo CSV. Valores válidos: true: A primeira linha do arquivo CSV contém os nomes dos campos. false: A primeira linha do arquivo CSV contém dados. Nota Este parâmetro é obrigatório se o parâmetro FileType for definido como CSV.
IgnoreError	Boolean	Não	false	Indica se deve ignorar erros durante a execução. Valores válidos: true: ignora o erro e continua a executar as instruções SQL. false: interrompe a execução das instruções SQL.
ImportMode	String	Não	FAST_MODE	Modo de importação. Valores válidos: FAST_MODE: Na etapa Execute, o sistema lê o arquivo carregado e executa as instruções SQL para importar dados ao banco de destino. Comparado ao modo seguro, este método é menos seguro, porém mais eficiente. SAFE_MODE: Na etapa Precheck, o sistema analisa o arquivo carregado e armazena em cache as instruções SQL ou os dados do arquivo CSV. Na etapa Execute, ele lê e executa as instruções SQL em cache para importar dados, ou lê os dados CSV em cache e os importa ao banco de destino especificado. Este método é mais seguro, porém menos eficiente.
RollbackSQL	String	Não	empty	Instruções SQL para reverter a importação de dados. Nota Este parâmetro é obrigatório se o parâmetro RollbackSqlType for definido como TEXT.
RollbackAttachmentName	String	Não	rollback.sql	Chave do anexo com as instruções SQL para reverter a importação de dados. Chame a operação GetUserUploadFileJob para obter essa chave a partir do valor do parâmetro AttachmentKey. Nota Este parâmetro é obrigatório se o parâmetro RollbackSqlType for definido como ATTACHMENT.
RollbackSqlType	String	Não	TEXT	Formato das instruções SQL para reverter a importação de dados. Valores válidos: TEXT: texto ATTACHMENT: anexo
AttachmentKey	String	Não	order_attachment.txt	Chave do anexo com instruções adicionais para o ticket. Chame a operação GetUserUploadFileJob para obter essa chave a partir do valor do parâmetro AttachmentKey.
Tid	Long	Não	3***	ID do locatário. Chame a operação GetUserActiveTenant ou ListUserTenants para obter esse ID.
RegionId	String	Não	cn-hangzhou	ID da região onde o DMS está ativado. Para obter mais informações, consulte Parâmetro RegionID.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	0C1CB646-1DE4-4AD0-B4A4-7D47DD52E931	ID da solicitação.
Success	Boolean	true	Indica se a solicitação foi bem-sucedida. Valores válidos: true: A solicitação foi bem-sucedida. false: A solicitação falhou.
ErrorMessage	String	UnknownError	Mensagem de erro retornada se a solicitação falhar.
ErrorCode	String	UnknownError	Código de erro retornado se a solicitação falhar.
CreateOrderResult	Array of Long	1****	ID do ticket.

Exemplos

Exemplos de solicitações

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>

Exemplos de respostas de sucesso

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 erro

Para obter uma lista de códigos de erro, visite o Centro de Erros de API.