Atualiza um arquivo.
Ao depurar ou chamar esta operação, especifique novos valores para os parâmetros de um nó. Por exemplo, se o valor original de um parâmetro for A, altere-o para B antes de enviar o nó. Se você definir o parâmetro como A, ocorrerá uma exceção de dados inválidos.
Depuração
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Exemplo |
Descrição |
|
Action |
String |
Sim |
UpdateFile |
A operação a ser executada. |
|
FileFolderPath |
String |
Não |
Workflow/1/Data Integration/Folder 1/Folder 2 |
O caminho do arquivo. |
|
ProjectId |
Long |
Não |
10000 |
O ID do workspace do DataWorks. Faça login no console do DataWorks e acesse a página Workspace para obter o ID. |
|
FileName |
String |
Não |
ods_user_info_d |
O nome do arquivo. Defina o parâmetro FileName com outro valor para alterar o nome do arquivo. Chame a operação ListFiles para consultar o ID do arquivo cujo nome deseja alterar. Em seguida, chame a operação UpdateFile para modificar o nome, definindo o parâmetro FileId com o ID consultado e o parâmetro FileName com o novo valor. |
|
FileDescription |
String |
Não |
Descrição do arquivo |
A descrição do arquivo. |
|
Content |
String |
Não |
SELECT "1"; |
O código do arquivo. O formato varia conforme o tipo de arquivo. Para visualizar o formato de um tipo específico, acesse o Operation Center, abra o DAG de um nó desse tipo, clique em com o botão direito no nó e selecione View Code. |
|
AutoRerunTimes |
Integer |
Sim |
3 |
O número de reexecuções automáticas permitidas após a ocorrência de um erro. |
|
AutoRerunIntervalMillis |
Integer |
Não |
120000 |
O intervalo entre reexecuções automáticas após a ocorrência de um erro. Unidade: milissegundo. Valor máximo: 1800000 (30 minutos). Este parâmetro corresponde ao parâmetro Rerun interval exibido após marcar a caixa de seleção Auto Rerun upon Error na seção Schedule da aba Properties no console do DataWorks. O intervalo definido no console do DataWorks é medido em minutos. Atenção à conversão entre as unidades de tempo ao chamar a operação. |
|
RerunMode |
String |
Não |
ALL_ALLOWED |
Define se o nó correspondente ao arquivo pode ser reexecutado. Valores válidos:
Este parâmetro corresponde ao parâmetro Rerun na seção Schedule da aba Properties no console do DataWorks. |
|
Stop |
Boolean |
Não |
false |
Indica se o agendamento do nó deve ser suspenso. Valores válidos:
Este parâmetro corresponde ao parâmetro Recurrence na seção Schedule da aba Properties no console do DataWorks. |
|
ParaValue |
String |
Não |
x=a y=b z=c |
Os parâmetros de agendamento do nó. Este parâmetro corresponde à seção Scheduling Parameter da aba Properties no console do DataWorks. Para mais informações sobre as configurações de parâmetros de agendamento, consulte Configurar parâmetros de agendamento. |
|
StartEffectDate |
Long |
Não |
936923400000 |
A hora de início do agendamento automático. Defina o valor como um timestamp UNIX representando o número de milissegundos decorridos desde 1º de janeiro de 1970, 00:00:00 UTC. Este parâmetro corresponde à hora inicial especificada no parâmetro Validity Period na seção Schedule da aba Properties no console do DataWorks. |
|
EndEffectDate |
Long |
Não |
4155787800000 |
A hora de término do agendamento automático. Defina o valor como um timestamp UNIX representando o número de milissegundos decorridos desde 1º de janeiro de 1970, 00:00:00 UTC. Este parâmetro corresponde à hora final especificada no parâmetro Validity Period na seção Schedule da aba Properties no console do DataWorks. |
|
CronExpress |
String |
Não |
00 00-59/5 1-23 ? |
A expressão CRON que representa a política de agendamento periódico do nó. Este parâmetro corresponde ao parâmetro Cron Expression na seção Schedule da aba Properties no console do DataWorks. Após configurar os parâmetros Scheduling Cycle e Scheduled time no console do DataWorks, o sistema gera o valor do parâmetro Cron Expression. Exemplos:
O sistema de agendamento do DataWorks impõe os seguintes limites nas expressões CRON:
|
|
CycleType |
String |
Não |
NOT_DAY |
O tipo de ciclo de agendamento do nó correspondente ao arquivo. Valores válidos: NOT_DAY e DAY. O valor NOT_DAY indica agendamento por minuto ou hora. O valor DAY indica agendamento por dia, semana ou mês. Este parâmetro corresponde ao parâmetro Scheduling Cycle na seção Schedule da aba Properties no console do DataWorks. |
|
DependentType |
String |
Não |
USER_DEFINE |
O tipo de dependência de agendamento entre ciclos do nó. Valores válidos:
|
|
DependentNodeIdList |
String |
Não |
5,10,15,20 |
O ID do nó do qual o nó correspondente ao arquivo depende quando o parâmetro DependentType está definido como USER_DEFINE. Separe vários IDs com vírgulas (,). O valor deste parâmetro corresponde ao ID do nó especificado após selecionar Previous Cycle e definir Depend On como Other Nodes na seção Dependencies da aba Properties no console do DataWorks. |
|
InputList |
String |
Não |
project_root,project.file1,project.001_out |
O nome de saída do arquivo pai do qual o arquivo atual depende. Se especificar vários nomes de saída, separe-os com vírgulas (,). Este parâmetro corresponde ao parâmetro Parent Nodes exibido após selecionar Same Cycle na seção Dependencies da aba Properties no console do DataWorks. |
|
ProjectIdentifier |
String |
Não |
dw_project |
O nome do workspace do DataWorks. Faça login no console do DataWorks e acesse a página Workspace para obter o nome do workspace. Configure este parâmetro ou o parâmetro ProjectId para determinar o workspace do DataWorks ao qual a operação será aplicada. |
|
FileId |
Long |
Sim |
100000001 |
O ID do arquivo. Chame a operação ListFiles para obter o ID. |
|
OutputList |
String |
Não |
dw_project.ods_user_info_d |
O nome de saída do arquivo atual. Este parâmetro corresponde ao parâmetro Output na seção Dependencies da aba Properties no console do DataWorks. |
|
ResourceGroupIdentifier |
String |
Não |
default_group |
O identificador do grupo de recursos usado para executar o nó correspondente ao arquivo. Chame a operação ListResourceGroups para consultar os grupos de recursos disponíveis no workspace. |
|
ConnectionName |
String |
Não |
odps_source |
O nome da fonte de dados usada para executar o nó. Chame a operação ListDataSources para consultar as fontes de dados disponíveis no workspace. |
|
Owner |
String |
Não |
18023848927592 |
O ID do proprietário do arquivo. |
|
AutoParsing |
Boolean |
Não |
true |
Indica se o recurso de análise automática deve ser ativado para o arquivo. Valores válidos:
Este parâmetro corresponde ao parâmetro Automatic Parsing From Code Before Node Committing exibido após selecionar Same Cycle na seção Dependencies da aba Properties no console do DataWorks. |
|
SchedulerType |
String |
Não |
NORMAL |
O tipo de agendamento do nó. Valores válidos:
|
|
AdvancedSettings |
String |
Não |
{"queue":"default","SPARK_CONF":"--conf spark.driver.memory=2g"} |
As configurações avançadas do nó. Este parâmetro é válido apenas para um nó EMR Spark Streaming ou EMR Streaming SQL. Ele corresponde à aba Advanced Settings do nó no console do DataWorks. O valor deste parâmetro deve estar no formato JSON. |
|
StartImmediately |
Boolean |
Não |
true |
Indica se o nó deve ser executado imediatamente após a implantação no ambiente de produção. Valores válidos:
Este parâmetro é válido apenas para um nó EMR Spark Streaming ou EMR Streaming SQL. Ele corresponde ao parâmetro Start Method na seção Schedule da aba Configure no console do DataWorks. |
|
InputParameters |
String |
Não |
[{"ValueSource": "project_001.first_node:bizdate_param","ParameterName": "bizdate_input"}] |
Os parâmetros de entrada do nó. O valor deste parâmetro deve estar no formato JSON. Para mais informações sobre os parâmetros de entrada, consulte o parâmetro InputContextParameterList na seção Response parameters da operação GetFile. Este parâmetro corresponde à tabela Input Parameters na seção Input and Output Parameters da aba Properties no console do DataWorks. |
|
OutputParameters |
String |
Não |
[{"Type": 1,"Value": "${bizdate}","ParameterName": "bizdate_param"}] |
Os parâmetros de saída do nó. O valor deste parâmetro deve estar no formato JSON. Para mais informações sobre os parâmetros de saída, consulte o parâmetro OutputContextParameterList na seção Response parameters da operação GetFile. Este parâmetro corresponde à tabela Output Parameters na seção Input and Output Parameters da aba Properties no console do DataWorks. |
|
IgnoreParentSkipRunningProperty |
Boolean |
Não |
true |
Indica se a propriedade de execução simulada (dry-run) dos nós ancestrais deve ser ignorada. Este parâmetro corresponde ao parâmetro Skip the dry-run property of the ancestor node exibido após configurar o parâmetro Depend On na seção Dependencies da aba Properties no console do DataWorks. |
Parâmetros de resposta
|
Parâmetro |
Tipo |
Exemplo |
Descrição |
|
HttpStatusCode |
Integer |
200 |
O código de status HTTP. |
|
ErrorMessage |
String |
The connection does not exist. |
A mensagem de erro. |
|
RequestId |
String |
0000-ABCD-EFGH-IJKLMNOPQ |
O ID da solicitação. |
|
ErrorCode |
String |
Invalid.Tenant.ConnectionNotExists |
O código de erro. |
|
Success |
Boolean |
true |
Indica se a solicitação foi bem-sucedida. Valores válidos:
|
Exemplos
Exemplos de solicitações
http(s)://[Endpoint]/?Action=UpdateFile
&FileFolderPath=Workflow/1/Data Integration/Folder 1/Folder 2
&ProjectId=10000
&FileName=ods_user_info_d
&FileDescription=File description
&Content=SELECT "1";
&AutoRerunTimes=3
&AutoRerunIntervalMillis=120000
&RerunMode=ALL_ALLOWED
&Stop=false
&ParaValue=x=a y=b z=c
&StartEffectDate=936923400000
&EndEffectDate=4155787800000
&CronExpress=00 00-59/5 1-23 * * ?
&CycleType=NOT_DAY
&DependentType=USER_DEFINE
&DependentNodeIdList=5,10,15,20
&InputList=project_root,project.file1,project.001_out
&ProjectIdentifier=dw_project
&FileId=100000001
&OutputList=dw_project.ods_user_info_d
&ResourceGroupIdentifier=default_group
&ConnectionName=odps_source
&Owner=18023848927592
&AutoParsing=true
&SchedulerType=NORMAL
&AdvancedSettings={"queue":"default","SPARK_CONF":"--conf spark.driver.memory=2g"}
&StartImmediately=true
&InputParameters=[{"ValueSource": "project_001.first_node:bizdate_param","ParameterName": "bizdate_input"}]
&OutputParameters=[{"Type": 1,"Value": "${bizdate}","ParameterName": "bizdate_param"}]
&IgnoreParentSkipRunningProperty=true
&<Common request parameters>
Exemplos de respostas de sucesso
Formato XML
HTTP/1.1 200 OK
Content-Type:application/xml
<UpdateFileResponse>
<HttpStatusCode>200</HttpStatusCode>
<ErrorMessage>The connection does not exist.</ErrorMessage>
<RequestId>0000-ABCD-EFGH-IJKLMNOPQ</RequestId>
<ErrorCode>Invalid.Tenant.ConnectionNotExists</ErrorCode>
<Success>true</Success>
</UpdateFileResponse>
Formato JSON
HTTP/1.1 200 OK
Content-Type:application/json
{
"HttpStatusCode" : 200,
"ErrorMessage" : "The connection does not exist.",
"RequestId" : "0000-ABCD-EFGH-IJKLMNOPQ",
"ErrorCode" : "Invalid.Tenant.ConnectionNotExists",
"Success" : true
}
Códigos de erro
|
Código de status HTTP |
Código de erro |
Mensagem de erro |
Descrição |
|
429 |
Throttling.Api |
The request for this resource has exceeded your available limit. |
O número de solicitações para o recurso excedeu o limite superior. |
|
429 |
Throttling.System |
The DataWorks system is busy. Try again later. |
O sistema do DataWorks está ocupado. Tente novamente mais tarde. |
|
429 |
Throttling.User |
Your request is too frequent. Try again later. |
Foram enviadas solicitações excessivas em um curto período. Tente novamente mais tarde. |
|
500 |
InternalError.System |
An internal system error occurred. Try again later. |
Ocorreu um erro interno. Tente novamente mais tarde. |
|
500 |
InternalError.UserId.Missing |
An internal system error occurred. Try again later. |
Ocorreu um erro interno. Tente novamente mais tarde. |
Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.