Compartilhar via


Datasets - Update Parameters

Atualizações os valores de parâmetros para o conjunto de dados especificado de Meu workspace.

Observação

É recomendável usar metadados de conjunto de dados aprimorados com essa chamada à API.

Importante

  • Se você estiver usando metadados aprimorados do conjunto de dados, atualize o conjunto de dados para aplicar os novos valores de parâmetro.
  • Se você não estiver usando metadados aprimorados do conjunto de dados, aguarde 30 minutos para que a operação de atualização de fontes de dados seja concluída e atualize o conjunto de dados.

Permissões

O usuário deve ser o proprietário do conjunto de dados.

Escopo necessário

Dataset.ReadWrite.All

Limitações

  • Não há suporte para conjuntos de dados criados ou modificados usando o ponto de extremidade XMLA público. Para fazer alterações nesses conjuntos de dados, o administrador deve usar a biblioteca de clientes Azure Analysis Services para o Modelo de Objeto Tabular.
  • As conexões directQuery só têm suporte com metadados aprimorados do conjunto de dados.
  • Não há suporte para conjuntos de dados com conexões dinâmicas Azure Analysis Services.
  • Máximo de 100 parâmetros por solicitação.
  • Todos os parâmetros especificados devem existir no conjunto de dados.
  • Os valores de parâmetros devem ser do tipo esperado.
  • A lista de parâmetros não pode estar vazia nem incluir parâmetros duplicados.
  • Os nomes de parâmetros diferenciam maiúsculas de minúsculas.
  • O parâmetro IsRequired deve ter um valor não vazio.
  • Os tipos Any de parâmetro e Binary não podem ser atualizados.

POST https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/Default.UpdateParameters

Parâmetros de URI

Nome Em Obrigatório Tipo Description
datasetId
path True

string

A ID do conjunto de dados

Corpo da solicitação

Nome Obrigatório Tipo Description
updateDetails True

UpdateMashupParameterDetails[]

Uma lista de parâmetros de conjunto de dados a serem atualizados

Respostas

Nome Tipo Description
200 OK

OK

Exemplos

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.UpdateParameters
{
  "updateDetails": [
    {
      "name": "DatabaseName",
      "newValue": "NewDB"
    },
    {
      "name": "MaxId",
      "newValue": "5678"
    }
  ]
}

Sample Response

Definições

Nome Description
UpdateMashupParameterDetails

Os detalhes da atualização de um parâmetro de conjunto de dados do Power BI

UpdateMashupParametersRequest

Uma solicitação de atualização para um parâmetro de conjunto de dados do Power BI

UpdateMashupParameterDetails

Os detalhes da atualização de um parâmetro de conjunto de dados do Power BI

Nome Tipo Description
name

string

O nome do parâmetro

newValue

string

O novo valor para o parâmetro

UpdateMashupParametersRequest

Uma solicitação de atualização para um parâmetro de conjunto de dados do Power BI

Nome Tipo Description
updateDetails

UpdateMashupParameterDetails[]

Uma lista de parâmetros de conjunto de dados a serem atualizados