Datasets - Update Direct Query Refresh Schedule In Group

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

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

Escopo necessário

Dataset.ReadWrite.All

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

Parâmetros de URI

Nome Em Obrigatório Tipo Description
datasetId
path True

string

A ID do conjunto de dados

groupId
path True

string

uuid

A ID do workspace

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

Set a days and times based schedule example
Set a frequency based schedule example
Update the times of an existing days and times based schedule example

Set a days and times based schedule example

Sample Request

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

Sample Response

Set a frequency based schedule example

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/directQueryRefreshSchedule
{
  "value": {
    "frequency": 30
  }
}

Sample Response

Update the times of an existing days and times based schedule example

Sample Request

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

Sample Response

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