Condividi tramite

Come scrivere stored procedure e trigger in Azure Cosmos DB utilizzando l'API di query JavaScript

  • Si applica a: ✅ NoSQL

Azure Cosmos DB consente di eseguire query ottimizzate usando un'interfaccia JavaScript fluente senza la necessità di conoscere il linguaggio SQL, il quale può essere utilizzato per scrivere stored procedure o trigger. Per altre informazioni sul supporto dell'API query JavaScript in Azure Cosmos DB, vedere l'articolo Uso dell'API di query integrata del linguaggio JavaScript in Azure Cosmos DB .

Procedura memorizzata utilizzando l'API di query JavaScript

L'esempio di codice seguente è un esempio di come viene usata l'API di query JavaScript nel contesto di una stored procedure. La stored procedure inserisce un elemento di Azure Cosmos DB specificato da un parametro di input e aggiorna un documento di metadati usando il __.filter() metodo , con minSize, maxSize e totalSize in base alla proprietà size dell'elemento di input.

Annotazioni

__ (doppio carattere di sottolineatura) è un alias per getContext().getCollection() quando si usa l'API di query JavaScript.

/**
 * Insert an item and update metadata doc: minSize, maxSize, totalSize based on item.size.
 */
function insertDocumentAndUpdateMetadata(item) {
  // HTTP error codes sent to our callback function by CosmosDB server.
  var ErrorCode = {
    RETRY_WITH: 449,
  }

  var isAccepted = __.createDocument(__.getSelfLink(), item, {}, function(err, item, options) {
    if (err) throw err;

    // Check the item (ignore items with invalid/zero size and metadata itself) and call updateMetadata.
    if (!item.isMetadata && item.size > 0) {
      // Get the metadata. We keep it in the same container. it's the only item that has .isMetadata = true.
      var result = __.filter(function(x) {
        return x.isMetadata === true
      }, function(err, feed, options) {
        if (err) throw err;

        // We assume that metadata item was pre-created and must exist when this script is called.
        if (!feed || !feed.length) throw new Error("Failed to find the metadata item.");

        // The metadata item.
        var metaItem = feed[0];

        // Update metaDoc.minSize:
        // for 1st document use doc.Size, for all the rest see if it's less than last min.
        if (metaItem.minSize == 0) metaItem.minSize = item.size;
        else metaItem.minSize = Math.min(metaItem.minSize, item.size);

        // Update metaItem.maxSize.
        metaItem.maxSize = Math.max(metaItem.maxSize, item.size);

        // Update metaItem.totalSize.
        metaItem.totalSize += item.size;

        // Update/replace the metadata item in the store.
        var isAccepted = __.replaceDocument(metaItem._self, metaItem, function(err) {
          if (err) throw err;
          // Note: in case concurrent updates causes conflict with ErrorCode.RETRY_WITH, we can't read the meta again
          //       and update again because due to Snapshot isolation we will read same exact version (we are in same transaction).
          //       We have to take care of that on the client side.
        });
        if (!isAccepted) throw new Error("replaceDocument(metaItem) returned false.");
      });
      if (!result.isAccepted) throw new Error("filter for metaItem returned false.");
    }
  });
  if (!isAccepted) throw new Error("createDocument(actual item) returned false.");
}

Passaggi successivi

Vedere gli articoli seguenti per informazioni su stored procedure, trigger e funzioni definite dall'utente in Azure Cosmos DB:

  • Last updated on