Todos os produtos
Search

Este produto

    DataWorks:CreateDataSource

    Central de documentação

    DataWorks:CreateDataSource

    Última atualização: Oct 12, 2026

    Cria uma fonte de dados em um espaço de trabalho especificado para o ambiente de desenvolvimento ou produção.

    Descrição da operação

    1. Você deve adquirir o DataWorks Basic Edition ou uma edição mais avançada para usar esta API.

    2. Você deve ter pelo menos uma das seguintes funções no espaço de trabalho do DataWorks:

    • proprietário do tenant, administrador do espaço de trabalho, proprietário do projeto ou operador.

    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

    A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

    • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

    • API: A API que você pode chamar para executar a ação.

    • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

    • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

      • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

      • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

    • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

    • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

    Ação

    Nível de acesso

    Tipo de recurso

    Chave de condição

    Ação dependente

    dataworks:CreateDataSource

    get

    *All resources.

    *

    		 Nenhuma Nenhuma

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    ProjectId

    integer

    Sim

    O ID do espaço de trabalho do DataWorks. Você pode fazer logon no console do DataWorks e acessar a página Gerenciamento de Espaços de Trabalho para obter o ID.

    Este parâmetro especifica o espaço de trabalho do DataWorks usado para esta chamada de API.

    2
    Name

    string

    Sim

    O nome da fonte de dados. O nome pode conter letras, dígitos e sublinhados (_) e não pode começar com um dígito ou um sublinhado. O nome pode ter até 255 caracteres.

    demo_holo_datasource
    Type

    string

    Sim

    O tipo da fonte de dados. Mais de 70 tipos de fontes de dados são suportados. Referências: Tipos de fontes de dados.

    hologres
    ConnectionPropertiesMode

    string

    Sim

    A categoria na qual a fonte de dados é adicionada. Diferentes tipos de fontes de dados possuem diferentes subtipos e restrições de parâmetros. Por exemplo, uma fonte de dados MySQL suporta os seguintes modos:

    • InstanceMode: Modo de instância.

    • UrlMode: Modo de string de conexão.

    Valores válidos:

    • UrlMode :

      Modo URL.

    • InstanceMode :

      Modo de instância.

    • CdhMode :

      Modo CDH.

    UrlMode
    Description

    string

    Não

    A descrição da fonte de dados. A descrição pode ter até 3.000 caracteres.

    this is a holo datasource
    ConnectionProperties

    string

    Sim

    A configuração de conexão específica da fonte de dados, incluindo o endpoint, a identidade de acesso e o contexto de ambiente. A propriedade envType deste objeto especifica o ambiente da fonte de dados. Valores válidos:

    • Dev: Ambiente de desenvolvimento.

    • Prod: Ambiente de produção.

    Diferentes tipos de fontes de dados possuem diferentes especificações de propriedades em diferentes padrões de configuração (ConnectionPropertiesMode). Para mais informações, consulte ConnectionProperties.

    { "envType": "Prod", "regionId": "cn-beijing", "instanceId": "hgprecn-cn-x0r3oun4k001", "database": "testdb", "securityProtocol": "authTypeNone", "authType": "Executor", "authIdentity": "1107550004253538" }

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    A resposta.

    RequestId

    string

    O ID da solicitação. Você pode usar o ID para localizar logs e solucionar problemas.

    B62EC203-B39E-5DC1-B5B8-EB3C6****
    Id

    integer

    O ID da fonte de dados criada, que é o identificador exclusivo da fonte de dados.

    22130

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "RequestId": "B62EC203-B39E-5DC1-B5B8-EB3C6****",
  "Id": 22130
}

    Códigos de erro

    Consulte Códigos de Erro para uma lista completa.

    Notas de versão

    Consulte Notas de Versão para uma lista completa.