Datasets - Update Direct Query Refresh Schedule In Group
Mises à 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 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.
- 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 |
L’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
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
Définitions
Nom | Description |
---|---|
days |
Jours pendant lesquels exécuter l’actualisation |
Direct |
Planification d’actualisation Power BI pour DirectQuery ou LiveConnection, 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 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 |
Objet contenant les détails de la planification d’actualisation pour DirectQuery ou LiveConnection |