Datasets - Update Direct Query Refresh Schedule

  • Riferimento
Service:
Power BI REST APIs
API Version:
v1.0

Aggiornamenti la pianificazione dell'aggiornamento per un set di dati DirectQuery o LiveConnection specificato dall'area di lavoro personale.

Una richiesta deve contenere un set di giorni e ore o una frequenza valida, ma non entrambi. Se si sceglie un set di giorni senza specificare tempi, Power BI userà una singola ora predefinita al giorno. L'impostazione della frequenza sovrascriverà automaticamente l'impostazione giorni e orari.

Autorizzazioni

L'utente deve essere il proprietario del set di dati.

Ambito obbligatorio

Dataset.ReadWrite.All

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
datasetId
 path True

string

ID del set di dati

Corpo della richiesta

Nome Necessario Tipo Descrizione
value True

DirectQueryRefreshSchedule

Oggetto contenente i dettagli della pianificazione dell'aggiornamento per DirectQuery o LiveConnection

Risposte

Nome Tipo Descrizione
200 OK

OK

Esempio

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

Definizioni

Nome Descrizione
days

Giorni in cui eseguire l'aggiornamento
DirectQueryRefreshSchedule

Pianificazione dell'aggiornamento di Power BI per DirectQuery o LiveConnection, specificando la frequenza o una combinazione di giorni e ore.
DirectQueryRefreshScheduleRequest

Richiesta di pianificazione dell'aggiornamento di Power BI per DirectQuery o LiveConnection

days

Giorni in cui eseguire l'aggiornamento

Nome Tipo Descrizione
Friday

string

Monday

string

Saturday

string

Sunday

string

Thursday

string

Tuesday

string

Wednesday

string

DirectQueryRefreshSchedule

Pianificazione dell'aggiornamento di Power BI per DirectQuery o LiveConnection, specificando la frequenza o una combinazione di giorni e ore.

Nome Tipo Descrizione
days

days[]

Giorni in cui eseguire l'aggiornamento
frequency

integer

Intervallo in minuti tra aggiornamenti successivi. I valori supportati sono 15, 30, 60, 120 e 180.
localTimeZoneId

string

ID del fuso orario da usare. Per altre informazioni, vedere Informazioni sul fuso orario
times

string[]

Orari del giorno per eseguire l'aggiornamento

DirectQueryRefreshScheduleRequest

Richiesta di pianificazione dell'aggiornamento di Power BI per DirectQuery o LiveConnection

Nome Tipo Descrizione
value

DirectQueryRefreshSchedule

Oggetto contenente i dettagli della pianificazione dell'aggiornamento per DirectQuery o LiveConnection