LEGACY_TIME_PARSER_POLICY

  • Article

S’applique à : coche marquée oui Databricks SQL

Le paramètre de configuration LEGACY_TIME_PARSER_POLICY contrôle l’analyse et la mise en forme des dates et des horodatages ainsi que la gestion des dates antérieures au 15 octobre 1582.

Databricks SQL utilise la mise en forme définie dans Modèles de date/heure pour mapper les chaînes datetime aux valeurs datetime. Une fois qu’une valeur datetime est établie, elle doit être vérifiée par rapport à un calendrier.

Vous pouvez définir ce paramètre au niveau de la session à l’aide de l’instruction SET et au niveau global à l’aide des paramètres de configuration SQL ou de l’API d’entrepôt SQL.

Paramètres

Trois paramètres sont pris en charge :

  • LEGACY

    Quand LEGACY est défini, des champs superflus dans les valeurs de chaîne qui sont en trop par rapport au modèle spécifié sont acceptés. Le calendrier utilisé est le calendrier hybride julien et grégorien.

  • CORRECTED

    Quand CORRECTED est défini, la valeur de chaîne doit correspondre exactement à la chaîne de format. Le calendrier utilisé est le calendrier grégorien proleptique.

  • EXCEPTION

    QuandEXCEPTION est défini, Databricks SQL génère une erreur quand les résultats de LEGACY et de CORRECTED sont différents.

Valeur système par défaut

La valeur système par défaut de ce paramètre est EXCEPTION .

Exemples

> SET legacy_time_parser_policy = legacy;
> SELECT to_timestamp('2021-01-01 12:34:56', 'yyyy-MM-dd');
  2021-01-01 00:00:00

> SET legacy_time_parser_policy = corrected;
> SELECT to_timestamp('2021-01-01 12:34:56', 'yyyy-MM-dd');
  Text '2021-01-01 12:34:56' could not be parsed, unparsed text found at index 10