Partager via

GETCURRENTDATETIMESTATIC - Langage de requête dans Cosmos DB (dans Azure et Fabric)

  • S’applique à: ✅ Azure Cosmos DB for NoSQL, ✅ Cosmos DB in Microsoft Fabric

La GETCURRENTDATETIMESTATIC fonction retourne la même valeur de date et d’heure UTC pour tous les éléments de la requête, sous forme de chaîne ISO 8601. Cela est utile pour les horodatages cohérents entre les résultats de la requête.

Syntaxe

GETCURRENTDATETIMESTATIC()

Types de retour

Retourne la date et l’heure UTC actuelles sous forme de chaîne au format ISO 8601, cohérentes pour tous les éléments de la requête.

Examples

Cette section contient des exemples d’utilisation de cette construction de langage de requête.

Obtenir la date et l’heure actuelles statiques et non statiques

Dans cet exemple, la GETCURRENTDATETIMESTATIC fonction est utilisée pour renvoyer le même horodatage pour tous les éléments, tandis que GetCurrentDateTime retourne une valeur différente pour chaque élément.

SELECT
  i.id,
  i.pk AS partitionKey,
  GetCurrentDateTime() AS nonStaticDateTime,
  GETCURRENTDATETIMESTATIC() AS staticDateTime
FROM
    items i

[
  {
    "id": "1",
    "partitionKey": "A",
    "nonStaticDateTime": "2023-06-28T18:32:12.4500994Z",
    "staticDateTime": "2023-06-28T18:32:12.4499507Z"
  },
  {
    "id": "2",
    "partitionKey": "A",
    "nonStaticDateTime": "2023-06-28T18:32:12.4501101Z",
    "staticDateTime": "2023-06-28T18:32:12.4499507Z"
  },
  {
    "id": "3",
    "partitionKey": "B",
    "nonStaticDateTime": "2023-06-28T18:32:12.4501181Z",
    "staticDateTime": "2023-06-28T18:32:12.4401181Z"
  }
]

Remarques

  • Cette fonction statique est appelée une fois par partition.
  • Les versions statiques des fonctions système obtiennent uniquement leurs valeurs respectives une seule fois pendant la liaison, au lieu d’être exécutées à plusieurs reprises dans le runtime, comme c’est le cas pour les versions non statiques des mêmes fonctions.
  • Last updated on