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
- O usuário deve ser o proprietário do conjunto de dados.
- Essa chamada à API pode ser chamada por um perfil de entidade de serviço. Para obter mais informações, consulte: Perfis de entidade de serviço no Power BI Embedded.
Escopo necessário
Dataset.ReadWrite.All
PATCH https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}/directQueryRefreshScheduleParâmetros de URI
| Nome | Em | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
dataset
|
path | True |
string |
A ID do conjunto de dados |
|
group
|
path | True |
string uuid |
A ID do workspace |
Corpo da solicitação
| Nome | Obrigatório | Tipo | Description |
|---|---|---|---|
| value | True |
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 |
|
Direct |
Um agendamento de atualização do Power BI para DirectQuery ou LiveConnection, especificando a frequência ou uma combinação de dias e horas. |
|
Direct |
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 |
Um objeto que contém os detalhes do agendamento de atualização para DirectQuery ou LiveConnection |