Todos os produtos
Search

Este produto

    DataWorks:CreateUdfFile

    Central de documentação

    DataWorks:CreateUdfFile

    Última atualização: Sep 29, 2026

    Cria um arquivo para uma função no Data Studio.

    Experimente agora

    Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

    Testar

    Autorização RAM

    Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    FileFolderPath

    string

    Sim

    O caminho da pasta que contém o arquivo da função.

    Business_process/First_Business_Process/function/string_processing
    ProjectId

    integer

    Não

    O ID do espaço de trabalho do DataWorks. Para encontrá-lo, clique no ícone de chave inglesa no canto superior direito e navegue até a página de gerenciamento do espaço de trabalho.

    10000
    FileName

    string

    Sim

    O nome da função.

    StringConcat
    FunctionType

    string

    Sim

    A categoria da função, correspondente ao campo Tipo de Função no formulário Criar Função. Valores válidos: MATH (funções matemáticas), AGGREGATE (funções de agregação), STRING (funções de processamento de strings), DATE (funções de processamento de datas), ANALYTIC (funções de janela) e OTHER (outras funções).

    Valores válidos:

    • OTHER :

      其他函数

    • DATE :

      日期处理函数

    • AGGREGATE :

      聚合函数

    • STRING :

      字符串处理函数

    • ANALYTIC :

      窗口函数

    • MATH :

      数学运算函数

    STRING
    ClassName

    string

    Sim

    O nome da classe onde a função é definida, correspondente ao campo Nome da Classe no formulário Criar Função.

    com.alibaba.DataWorks.api.udf.StringConcat
    Resources

    string

    Sim

    Uma lista de nomes de recursos referenciados pela função, separada por vírgulas, correspondente ao campo Lista de Recursos no formulário Criar Função.

    string-concat-1.0.0.jar,commons-lang-2.6.jar
    UdfDescription

    string

    Não

    A descrição do propósito da função, correspondente ao campo Descrição no formulário Criar Função.

    Concatenate several strings to generate a new string
    CmdDescription

    string

    Não

    O formato de comando para invocar a função, correspondente ao campo Formato de Comando no formulário Criar Função.

    StringConcat(String... substrs)
    ParameterDescription

    string

    Não

    A descrição dos parâmetros da função, correspondente ao campo Descrição de Parâmetros no formulário Criar Função.

    List of strings to be connected
    ReturnValue

    string

    Não

    A descrição do valor de retorno, correspondente ao campo Valor de Retorno no formulário Criar Função.

    New strings generated by concatenating all strings before and after the input order
    Example

    string

    Não

    Um exemplo que demonstra como chamar a função, correspondente ao campo Exemplo no formulário Criar Função.

    StringConcat('a', 'b', 'c')
    ProjectIdentifier

    string

    Não

    O identificador exclusivo do espaço de trabalho do DataWorks, que é o identificador em inglês na parte superior da página do Data Studio onde você alterna entre espaços de trabalho.

    dw_project
    CreateFolderIfNotExists

    boolean

    Não

    Especifica se o diretório deve ser criado automaticamente caso o caminho especificado (FileFolderPath) não exista. Valores válidos:\n- true: Cria o diretório automaticamente se ele não existir.\n- false: A chamada falha se o diretório não existir.

    false

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    A resposta.

    HttpStatusCode

    integer

    O código de status HTTP.

    200
    Data

    integer

    O ID do arquivo após a criação bem-sucedida.

    100000002
    RequestId

    string

    O ID exclusivo desta solicitação. Use este ID para solução de problemas se ocorrer um erro.

    0000-ABCD-EFG****
    ErrorMessage

    string

    A mensagem de erro.

    The connection does not exist.
    Success

    boolean

    Indica se a solicitação foi bem-sucedida.\n- true\n- false.

    true
    ErrorCode

    string

    O código de erro.

    Invalid.Tenant.ConnectionNotExists

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "HttpStatusCode": 200,
  "Data": 100000002,
  "RequestId": "0000-ABCD-EFG****",
  "ErrorMessage": "The connection does not exist.",
  "Success": true,
  "ErrorCode": "Invalid.Tenant.ConnectionNotExists"
}

    Códigos de erro

    Código de status HTTP

    Código de erro

    Mensagem de erro

    Descrição
    500 InternalError.System An internal system error occurred. Try again later.
    500 InternalError.UserId.Missing An internal system error occurred. Try again later.
    403 Forbidden.Access Access is forbidden. Please first activate DataWorks Enterprise Edition or Flagship Edition. Acesso negado. Autorize o acesso.
    429 Throttling.Api The request for this resource has exceeded your available limit.
    429 Throttling.System The DataWorks system is busy. Try again later.
    429 Throttling.User Your request is too frequent. Try again later.

    Consulte Códigos de Erro para uma lista completa.

    Notas de versão

    Consulte Notas de Versão para uma lista completa.