Datasets - Update Direct Query Refresh Schedule

  • Referência
Service:
Power BI REST APIs
API Version:
v1.0

Atualizações o agendamento de atualização de um conjunto de dados DirectQuery ou LiveConnection especificado de 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 nenhuma hora, o Power BI usará uma única hora padrão por dia. Definir a frequência substituirá automaticamente a configuração de dias e horas.

Permissões

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

OK

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

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/directQueryRefreshSchedule
Request Body
{
  "value": {
    "enabled": false
  }
}

Sample Response

Status code:
200

Set a days and times based schedule example

Sample Request

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

Sample Response

Status code:
200

Set a frequency based schedule example

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/directQueryRefreshSchedule
Request Body
{
  "value": {
    "frequency": 30
  }
}

Sample Response

Status code:
200

Update the times of a days and times based schedule example

Sample Request

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

Sample Response

Status code:
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

Os dias em que executar a atualização

Nome Tipo Description
Friday

string

Monday

string

Saturday

string

Sunday

string

Thursday

string

Tuesday

string

Wednesday

string

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.

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

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