Partager via


Datasets - Update Direct Query Refresh Schedule In Group

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

Une requête 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 de fois, 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.

Permissions

Étendue requise

Dataset.ReadWrite.All

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

Paramètres URI

Nom Dans Obligatoire Type Description
datasetId
path True

string

ID du jeu de données

groupId
path True

string (uuid)

ID de l’espace de travail

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

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

Exemple de requête

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"
  }
}

Exemple de réponse

Set a frequency based schedule example

Exemple de requête

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

Exemple de réponse

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

Exemple de requête

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"
    ]
  }
}

Exemple de réponse

Définitions

Nom Description
days

Jours sur lesquels exécuter l’actualisation

DirectQueryRefreshSchedule

Planification d’actualisation de Power BI pour DirectQuery ou LiveConnection, en 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 sur lesquels exécuter l’actualisation

Valeur Description
Monday
Tuesday
Wednesday
Thursday
Friday
Saturday
Sunday

DirectQueryRefreshSchedule

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

Nom Type Description
days

days[]

Jours sur 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 les informations du fuseau horaire

times

string[]

Heures de la journée d’exécution de 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