ALTER STREAMING TABLE
S’applique à : Databricks SQL
Vous permet soit de :
- Ajoutez une planification pour actualiser une tablede diffusion en continu existante.
- Modifiez un programme refresh existant pour une tablede diffusion en continu.
- Supprimez la planification refresh pour une diffusion en continu table. Si la planification est supprimée, l'objet doit être actualisé manuellement pour refléter les dernières données.
Pour ajouter ou modifier un commentaire sur un table ou son columns, utilisez COMMENT ON.
Syntaxe
ALTER STREAMING TABLE table_name
{
{ ADD | ALTER } SCHEDULE [ REFRESH ] schedule_clause |
DROP SCHEDULE
}
schedule_clause
{ EVERY number { HOUR | HOURS | DAY | DAYS | WEEK | WEEKS } |
CRON cron_string [ AT TIME ZONE timezone_id ] }
Parameters
-
Nom de la table de diffusion en continu pour modifier la définition de. Le nom ne doit pas inclure une spécification temporelle.
SCHEDULE [ REFRESH ] schedule_clause
Permet d'ajouter ou de modifier l'horaire d'une diffusion en continu table.
EVERY number { HOUR | HOURS | DAY | DAYS | WEEK | WEEKS }
Pour planifier une refresh qui se produit régulièrement, utilisez la syntaxe
EVERY
. Si la syntaxeEVERY
est spécifiée, la diffusion en continu table ou la vue matérialisée est actualisée à intervalles réguliers spécifiés en fonction de la valeur fournie, telle queHOUR
,HOURS
,DAY
,DAYS
,WEEK
ouWEEKS
. Les table suivants répertorient les entiers values acceptés pournumber
.Unité de temps Valeur entière HOUR or HOURS
1 <= H <= 72 DAY or DAYS
1 <= D <= 31 WEEK or WEEKS
1 <= W <= 8 Remarque
Les formes singulières et plurielles de l’unité de temps incluse sont sémantiquement équivalentes.
CRON cron_string [ AT TIME ZONE timezone_id ]
Pour planifier un refresh à l’aide d’une valeur de cron de quartz. Les time_zone_values valides sont acceptées. La fonction
AT TIME ZONE LOCAL
n'est pas prise en charge.Si
AT TIME ZONE
est absent, le fuseau horaire de session est utilisé. SiAT TIME ZONE
est absent et que le fuseau horaire de session n’est pas set, une erreur est levée.SCHEDULE
est équivalent sémantiquement àSCHEDULE REFRESH
.
Exemples
-- Adds a schedule to refresh the streaming table once a day
-- at midnight in Los Angeles
> ALTER STREAMING TABLE my_st
ADD SCHEDULE CRON '0 0 0 * * ? *' AT TIME ZONE 'America/Los_Angeles';
-- Alters the schedule to run every 15 minutes for a streaming table
> ALTER STREAMING TABLE my_st
ALTER SCHEDULE EVERY 15 MINUTES;
-- Drops the schedule for a streaming table
> ALTER STREAMING TABLE my_st
DROP SCHEDULE;