Partilhar via

Datasets - Update Direct Query Refresh Schedule

Serviço:
Power BI REST APIs
Versão da API:
v1.0

Atualiza o agendamento de atualização de um conjunto de dados DirectQuery ou LiveConnection especificado do Meu workspace.

Uma solicitação deve conter um conjunto de dias e horas ou uma frequência válida, mas não ambos. Se você escolher um conjunto de dias sem especificar horários, o Power BI usará uma hora única padrão por dia. Definir a frequência substituirá automaticamente a configuração de dias e horas.

Permissions

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

Escopo necessário

Dataset.ReadWrite.All 

PATCH https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/directQueryRefreshSchedule

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
value True

DirectQueryRefreshSchedule

Um objeto que contém os detalhes do agendamento de atualização para DirectQuery ou LiveConnection

Respostas

Nome Tipo Description
200 OK

OKEY

Exemplos

Disable a scheduled refresh example
Set a days and times based schedule example
Set a frequency based schedule example
Update the times of a days and times based schedule example

Disable a scheduled refresh example

Solicitação de exemplo

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/directQueryRefreshSchedule
Corpo da solicitação
{
  "value": {
    "enabled": false
  }
}

Resposta de exemplo

Código de status:
200

Set a days and times based schedule example

Solicitação de exemplo

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/directQueryRefreshSchedule
Corpo da solicitação
{
  "value": {
    "days": [
      "Sunday",
      "Tuesday",
      "Friday",
      "Saturday"
    ],
    "times": [
      "07:00",
      "11:30",
      "16:00",
      "23:30"
    ],
    "localTimeZoneId": "UTC"
  }
}

Resposta de exemplo

Código de status:
200

Set a frequency based schedule example

Solicitação de exemplo

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/directQueryRefreshSchedule
Corpo da solicitação
{
  "value": {
    "frequency": 30
  }
}

Resposta de exemplo

Código de status:
200

Update the times of a days and times based schedule example

Solicitação de exemplo

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/directQueryRefreshSchedule
Corpo da solicitação
{
  "value": {
    "times": [
      "07:00",
      "16:30",
      "23:30"
    ]
  }
}

Resposta de exemplo

Código de status:
200

Definições

Nome Description
days

Os dias em que executar a atualização
DirectQueryRefreshSchedule

Um agendamento de atualização do Power BI para DirectQuery ou LiveConnection, especificando a frequência ou uma combinação de dias e horas.
DirectQueryRefreshScheduleRequest

Solicitação de agendamento de atualização do Power BI para DirectQuery ou LiveConnection

days

Enumeração

Os dias em que executar a atualização

Valor Description
Monday
Tuesday
Wednesday
Thursday
Friday
Saturday
Sunday

DirectQueryRefreshSchedule

Objeto

Um agendamento de atualização do Power BI para DirectQuery ou LiveConnection, especificando a frequência ou uma combinação de dias e horas.

Nome Tipo Description
days

days[]

Os dias em que executar a atualização
frequency

integer

O intervalo em minutos entre atualizações sucessivas. Os valores com suporte são 15, 30, 60, 120 e 180.
localTimeZoneId

string

A ID do fuso horário a ser usado. Para obter mais informações, consulte informações de fuso horário
times

string[]

As horas do dia para executar a atualização

DirectQueryRefreshScheduleRequest

Objeto

Solicitação de agendamento de atualização do Power BI para DirectQuery ou LiveConnection

Nome Tipo Description
value

DirectQueryRefreshSchedule

Um objeto que contém os detalhes do agendamento de atualização para DirectQuery ou LiveConnection