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
- L’utilisateur doit être le propriétaire du jeu de données.
- Cet appel d’API peut être appelé par un profil de principal de service. Pour plus d’informations, consultez : Profils de principal de service dans Power BI Embedded.
É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 |
|---|---|---|---|---|
|
dataset
|
path | True |
string |
ID du jeu de données |
|
group
|
path | True |
string (uuid) |
ID de l’espace de travail |
Corps de la demande
| Nom | Obligatoire | Type | Description |
|---|---|---|---|
| value | True |
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 |
|
Direct |
Planification d’actualisation de Power BI pour DirectQuery ou LiveConnection, en spécifiant la fréquence ou une combinaison de jours et d’heures. |
|
Direct |
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 |
Objet contenant les détails de la planification d’actualisation pour DirectQuery ou LiveConnection |