1---
2id: post-dataset-refresh
3title: "Refresh Dataset"
4description: "Trigger an on-demand refresh for an accelerated dataset."
5sidebar_label: "Refresh Dataset"
6hide_title: true
7hide_table_of_contents: true
8api: eJzlV9tuGzcQ/RWCQIGkWOsSpECrhwJp7KIBErhxHPTBMbT0cqSlwyVpcla2Iey/F0NSu5LXdZL2rdGLJHI4nDlz5sItR7EOfHHBjwWKABj4ZcElhMorh8oavuDnXq3X4JkwzJojCY0wknlYeQg1W9m4IaoKNHiBIJlMmiafzCdzXqvAwEhnlUGGSVP4F6rOa+gFrdH3TDinFQSGlpWrVuuSka5SOAdGlr1sYyUE9sxYZGVVC7OGUMbF5xNecOvoImXNG8kX3NmAy3zlMivgBXfCiwYQPOG05UY0wBfpq+CKEHICSfABbDUwEmJ2xbCGnS9kcNZNFni4aZUHyRfoWyh4qGpoBF9sOd47uiegV2bNu+4yCUPA36y8J4nD+05HgGbxBCwLDiq1UlUPKi94ZQ2CQVIW8awiGNPrQBq3Y2Ps1TVUOHL1ojxLV55uwHslIZSXu/soRDWwypqVWrdeXGlgNh4M2TBlpNoo2QrNfGsILtG7gCJ8JkOdp1ChgkDW5N3ltUIEv2zE3WDjxQ6xgptW60foXANrxJ1q2oaJxrYG6cqkioIjpKQvHAg3YcewEq3GsNsoxxaUvcOSKROlglMVOCsLZj2bz37YMaE/XdVQfV4qg+A3QpfkKNyJxmnCej4LvCt6X4mz5KU1cLqKRMwxiV52xUM67CcMnSXT2wARc6Ss/LJzdOxLbqXcI8sP+VpwMG1D4ZAqUNAlLzjJ8oKnHCX6pYSkGKHC6HUm0jvytrvc8z/c6G8M8of3b1lAgdCAQfJdfovz4UY/6btaMWHuJ7zrRsb3WUDx6wO6PXSFfzh5e/L6nP3Ifj87fcdQ3KkleuUC++uPk7MThsotMz1/ZfPZZMYfcmEH52PZkNjTdQ8LTFwIzpqQMunFbD6uJLkVDEmYyjZIFtqqghDo4vv/Uj4Goy54AyGINVAMD7N8tzGqhY9mdBJmaedKmXXO4NBq3CVeLogHMXuXDp5lVB6ErLfhCVAiqfrwESNI/8vZbIzsq11vU9Yw6klgYm5kYvZN4jvFdi8JpIUQEarFBoaZgHDLmPU4v/xnBpOClW1Tsfm+AR2gSLj99Bg/31ArMkKzAH4DnoH31jNbVa0npt/WSgNz3lIRIKuHIel7QvejgTsHFca2kAH7WqS6hH4DWNvdzBlnTKz5gk8382kuAWG6pemxm+5zfzoAniKURtLWU0OpEd1iOtW2Erq2ARc/z36ZjRB6S9tMwga0dbEzJk0T9jqPaMBuFdasPDoijeWE0+gZoGq9wvt4n3Bq+Rno9yXtUZDPhtH0ZNzxxq2JJueVjQHN6PvWoIoz9Tikse1KNohoVQGFaNHP46+cqGo4ehEbpZJgkBq3P9zpCk6gJcXzycu0RDFohNlTlhs5O+7L8YFN24Hu/+fXUU41hDucOi2UIbAi17aZsBd8Mydwdm/Hgi/yu2iftcOMQplN1KST2+2VCPDR666j5ZsWfGRUwTfCKyrxkWv9+LhYCR3giUg8O8ul5Dn7urfXo/7lRWFowNkI3dI/XvDI98SPOJfWICTR62Kbt14nQ47OScFwdFQNaVRPJ2gacPik7OVeqfjz9MM5L/hVfv3lIdCLW8JX3CYz89MqJh+tbbkWZt2mwpV00udv0TOhPA==
9sidebar_class_name: "post api-method"
10info_path: docs/api/HTTP/runtime
11custom_edit_url: null
12proxy: http://localhost:8090
13---
14
15import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
16import ParamsDetails from "@theme/ParamsDetails";
17import RequestSchema from "@theme/RequestSchema";
18import StatusCodes from "@theme/StatusCodes";
19import OperationTabs from "@theme/OperationTabs";
20import TabItem from "@theme/TabItem";
21import Heading from "@theme/Heading";
22
23<Heading
24 as={"h1"}
25 className={"openapi__heading"}
26 children={"Refresh Dataset"}
27>
28</Heading>
29
30<MethodEndpoint
31 method={"post"}
32 path={"/v1/datasets/{name}/acceleration/refresh"}
33 context={"endpoint"}
34>
35
36</MethodEndpoint>
37
38
39
40Trigger an on-demand refresh for an accelerated dataset.
41
42This endpoint triggers an on-demand refresh for an accelerated dataset.
43The refresh only applies to `full` and `append` refresh modes (not `changes` mode).
44
45<Heading
46 id={"request"}
47 as={"h2"}
48 className={"openapi-tabs__heading"}
49 children={"Request"}
50>
51</Heading>
52
53<ParamsDetails
54 parameters={[{"name":"name","in":"path","description":"The name of the dataset to refresh.","required":true,"schema":{"type":"string"}}]}
55>
56
57</ParamsDetails>
58
59<RequestSchema
60 title={"Body"}
61 body={{"description":"On-demand refresh request for a specific dataset.","content":{"application/json":{"schema":{"type":"object","description":"[`RefreshOverrides`] specifies the configurable options for a individual run of a refresh task.","properties":{"refresh_jitter_max":{"type":["string","null"],"description":"The maximum amount of jitter to add to the refresh. Defaults to the `refresh_jitter_max` specified in the spicepod, or 10% of the `refresh_check_interval`.","example":"10s"},"refresh_mode":{"oneOf":[{"type":"null"},{"description":"The refresh mode to use for this refresh. Defaults to the `refresh_mode` specified in the spicepod, or `full`.","type":"string","enum":["disabled","full","append","changes"],"title":"RefreshMode"}]},"refresh_sql":{"type":["string","null"],"description":"The SQL statement used for this refresh. Defaults to the `refresh_sql` specified in the spicepod, if any."}},"title":"RefreshOverrides"},"example":{"refresh_sql":"SELECT * FROM taxi_trips WHERE tip_amount > 10.0","refresh_mode":"full","refresh_jitter_max":"10s"}}},"required":true}}
62>
63
64</RequestSchema>
65
66<StatusCodes
67 id={undefined}
68 label={undefined}
69 responses={{"201":{"description":"Dataset refresh triggered successfully","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"The message describing the result of the request"}},"title":"MessageResponse"},"example":{"message":"Dataset refresh triggered for taxi_trips."}}}},"400":{"description":"Acceleration not enabled for the dataset","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"The message describing the result of the request"}},"title":"MessageResponse"},"example":{"message":"Dataset taxi_trips does not have acceleration enabled"}}}},"404":{"description":"Dataset not found","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"The message describing the result of the request"}},"title":"MessageResponse"},"example":{"message":"Dataset taxi_trips not found"}}}},"500":{"description":"Internal server error occurred while processing refresh","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"The message describing the result of the request"}},"title":"MessageResponse"},"example":{"message":"Unexpected internal error occurred while processing refresh"}}}}}}
70>
71
72</StatusCodes>
73
74
75
1---
2id: post-dataset-refresh
3title: "Refresh Dataset"
4description: "Trigger an on-demand refresh for an accelerated dataset."
5sidebar_label: "Refresh Dataset"
6hide_title: true
7hide_table_of_contents: true
8api: eJzlV9tuGzcQ/RWCQIGkWOsSpECrhwJp7KIBErhxHPTBMbT0cqSlwyVpcla2Iey/F0NSu5LXdZL2rdGLJHI4nDlz5sItR7EOfHHBjwWKABj4ZcElhMorh8oavuDnXq3X4JkwzJojCY0wknlYeQg1W9m4IaoKNHiBIJlMmiafzCdzXqvAwEhnlUGGSVP4F6rOa+gFrdH3TDinFQSGlpWrVuuSka5SOAdGlr1sYyUE9sxYZGVVC7OGUMbF5xNecOvoImXNG8kX3NmAy3zlMivgBXfCiwYQPOG05UY0wBfpq+CKEHICSfABbDUwEmJ2xbCGnS9kcNZNFni4aZUHyRfoWyh4qGpoBF9sOd47uiegV2bNu+4yCUPA36y8J4nD+05HgGbxBCwLDiq1UlUPKi94ZQ2CQVIW8awiGNPrQBq3Y2Ps1TVUOHL1ojxLV55uwHslIZSXu/soRDWwypqVWrdeXGlgNh4M2TBlpNoo2QrNfGsILtG7gCJ8JkOdp1ChgkDW5N3ltUIEv2zE3WDjxQ6xgptW60foXANrxJ1q2oaJxrYG6cqkioIjpKQvHAg3YcewEq3GsNsoxxaUvcOSKROlglMVOCsLZj2bz37YMaE/XdVQfV4qg+A3QpfkKNyJxmnCej4LvCt6X4mz5KU1cLqKRMwxiV52xUM67CcMnSXT2wARc6Ss/LJzdOxLbqXcI8sP+VpwMG1D4ZAqUNAlLzjJ8oKnHCX6pYSkGKHC6HUm0jvytrvc8z/c6G8M8of3b1lAgdCAQfJdfovz4UY/6btaMWHuJ7zrRsb3WUDx6wO6PXSFfzh5e/L6nP3Ifj87fcdQ3KkleuUC++uPk7MThsotMz1/ZfPZZMYfcmEH52PZkNjTdQ8LTFwIzpqQMunFbD6uJLkVDEmYyjZIFtqqghDo4vv/Uj4Goy54AyGINVAMD7N8tzGqhY9mdBJmaedKmXXO4NBq3CVeLogHMXuXDp5lVB6ErLfhCVAiqfrwESNI/8vZbIzsq11vU9Yw6klgYm5kYvZN4jvFdi8JpIUQEarFBoaZgHDLmPU4v/xnBpOClW1Tsfm+AR2gSLj99Bg/31ArMkKzAH4DnoH31jNbVa0npt/WSgNz3lIRIKuHIel7QvejgTsHFca2kAH7WqS6hH4DWNvdzBlnTKz5gk8382kuAWG6pemxm+5zfzoAniKURtLWU0OpEd1iOtW2Erq2ARc/z36ZjRB6S9tMwga0dbEzJk0T9jqPaMBuFdasPDoijeWE0+gZoGq9wvt4n3Bq+Rno9yXtUZDPhtH0ZNzxxq2JJueVjQHN6PvWoIoz9Tikse1KNohoVQGFaNHP46+cqGo4ehEbpZJgkBq3P9zpCk6gJcXzycu0RDFohNlTlhs5O+7L8YFN24Hu/+fXUU41hDucOi2UIbAi17aZsBd8Mydwdm/Hgi/yu2iftcOMQplN1KST2+2VCPDR666j5ZsWfGRUwTfCKyrxkWv9+LhYCR3giUg8O8ul5Dn7urfXo/7lRWFowNkI3dI/XvDI98SPOJfWICTR62Kbt14nQ47OScFwdFQNaVRPJ2gacPik7OVeqfjz9MM5L/hVfv3lIdCLW8JX3CYz89MqJh+tbbkWZt2mwpV00udv0TOhPA==
9sidebar_class_name: "post api-method"
10info_path: docs/api/HTTP/runtime
11custom_edit_url: null
12proxy: http://localhost:8090
13---
14
15import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
16import ParamsDetails from "@theme/ParamsDetails";
17import RequestSchema from "@theme/RequestSchema";
18import StatusCodes from "@theme/StatusCodes";
19import OperationTabs from "@theme/OperationTabs";
20import TabItem from "@theme/TabItem";
21import Heading from "@theme/Heading";
22
23<Heading
24 as={"h1"}
25 className={"openapi__heading"}
26 children={"Refresh Dataset"}
27>
28</Heading>
29
30<MethodEndpoint
31 method={"post"}
32 path={"/v1/datasets/{name}/acceleration/refresh"}
33 context={"endpoint"}
34>
35
36</MethodEndpoint>
37
38
39
40Trigger an on-demand refresh for an accelerated dataset.
41
42This endpoint triggers an on-demand refresh for an accelerated dataset.
43The refresh only applies to `full` and `append` refresh modes (not `changes` mode).
44
45<Heading
46 id={"request"}
47 as={"h2"}
48 className={"openapi-tabs__heading"}
49 children={"Request"}
50>
51</Heading>
52
53<ParamsDetails
54 parameters={[{"name":"name","in":"path","description":"The name of the dataset to refresh.","required":true,"schema":{"type":"string"}}]}
55>
56
57</ParamsDetails>
58
59<RequestSchema
60 title={"Body"}
61 body={{"description":"On-demand refresh request for a specific dataset.","content":{"application/json":{"schema":{"type":"object","description":"[`RefreshOverrides`] specifies the configurable options for a individual run of a refresh task.","properties":{"refresh_jitter_max":{"type":["string","null"],"description":"The maximum amount of jitter to add to the refresh. Defaults to the `refresh_jitter_max` specified in the spicepod, or 10% of the `refresh_check_interval`.","example":"10s"},"refresh_mode":{"oneOf":[{"type":"null"},{"description":"The refresh mode to use for this refresh. Defaults to the `refresh_mode` specified in the spicepod, or `full`.","type":"string","enum":["disabled","full","append","changes"],"title":"RefreshMode"}]},"refresh_sql":{"type":["string","null"],"description":"The SQL statement used for this refresh. Defaults to the `refresh_sql` specified in the spicepod, if any."}},"title":"RefreshOverrides"},"example":{"refresh_sql":"SELECT * FROM taxi_trips WHERE tip_amount > 10.0","refresh_mode":"full","refresh_jitter_max":"10s"}}},"required":true}}
62>
63
64</RequestSchema>
65
66<StatusCodes
67 id={undefined}
68 label={undefined}
69 responses={{"201":{"description":"Dataset refresh triggered successfully","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"The message describing the result of the request"}},"title":"MessageResponse"},"example":{"message":"Dataset refresh triggered for taxi_trips."}}}},"400":{"description":"Acceleration not enabled for the dataset","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"The message describing the result of the request"}},"title":"MessageResponse"},"example":{"message":"Dataset taxi_trips does not have acceleration enabled"}}}},"404":{"description":"Dataset not found","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"The message describing the result of the request"}},"title":"MessageResponse"},"example":{"message":"Dataset taxi_trips not found"}}}},"500":{"description":"Internal server error occurred while processing refresh","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"The message describing the result of the request"}},"title":"MessageResponse"},"example":{"message":"Unexpected internal error occurred while processing refresh"}}}}}}
70>
71
72</StatusCodes>
73
74
75