Partager via

Datasets - Update Direct Query Refresh Schedule

  • Référence
Service:
Power BI REST APIs
API Version:
v1.0

Mises à jour la planification d’actualisation d’un jeu de données DirectQuery ou LiveConnection spécifié à partir de Mon espace de travail.

Une demande doit contenir un ensemble de jours et d’heures ou une fréquence valide, mais pas les deux. Si vous choisissez un ensemble de jours sans spécifier d’heures, Power BI utilise une seule heure par jour par défaut. La définition de la fréquence remplace automatiquement le paramètre jours et heures.

Autorisations

L’utilisateur doit être le propriétaire du jeu de données.

Étendue requise

Dataset.ReadWrite.All

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

Paramètres URI

Nom Dans Obligatoire Type Description
datasetId
 path True

string

ID du jeu de données

Corps de la demande

Nom Obligatoire Type Description
value True

DirectQueryRefreshSchedule

Objet contenant les détails de la planification d’actualisation pour DirectQuery ou LiveConnection

Réponses

Nom Type Description
200 OK

OK

Exemples

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

Définitions

Nom Description
days

Jours pendant lesquels exécuter l’actualisation
DirectQueryRefreshSchedule

Planification d’actualisation Power BI pour DirectQuery ou LiveConnection, spécifiant la fréquence ou une combinaison de jours et d’heures.
DirectQueryRefreshScheduleRequest

Demande de planification d’actualisation Power BI pour DirectQuery ou LiveConnection

days

Jours pendant lesquels exécuter l’actualisation

Nom Type Description
Friday

string

Monday

string

Saturday

string

Sunday

string

Thursday

string

Tuesday

string

Wednesday

string

DirectQueryRefreshSchedule

Planification d’actualisation Power BI pour DirectQuery ou LiveConnection, spécifiant la fréquence ou une combinaison de jours et d’heures.

Nom Type Description
days

days[]

Jours pendant lesquels exécuter l’actualisation
frequency

integer

Intervalle en minutes entre les actualisations successives. Les valeurs prises en charge sont 15, 30, 60, 120 et 180.
localTimeZoneId

string

ID du fuseau horaire à utiliser. Pour plus d’informations, consultez Informations de fuseau horaire
times

string[]

Heures de la journée pour exécuter l’actualisation

DirectQueryRefreshScheduleRequest

Demande de planification d’actualisation Power BI pour DirectQuery ou LiveConnection

Nom Type Description
value

DirectQueryRefreshSchedule

Objet contenant les détails de la planification d’actualisation pour DirectQuery ou LiveConnection