Funciones del sistema (Azure Cosmos DB)

SE APLICA A: SQL API

Cosmos DB proporciona muchas funciones de SQL integradas. Las categorías de las funciones integradas aparecen a continuación.

Grupo de funciones Descripción Operaciones
Funciones de matriz Las siguientes funciones de matriz realizan una operación en un valor de entrada de matriz y devuelven un valor numérico, booleano o de matriz. ARRAY_CONCAT, ARRAY_CONTAINS, ARRAY_LENGTH, ARRAY_SLICE
Funciones de fecha y hora Las funciones de fecha y hora le permiten obtener la fecha y la hora UTC actuales de dos formas: una marca de tiempo numérica cuyo valor es la época de Unix en milisegundos, o una cadena que se ajusta al formato ISO 8601. GetCurrentDateTime, GetCurrentTimestamp, GetCurrentTicks
Funciones matemáticas Las funciones matemáticas realizan un cálculo, basado normalmente en valores de entrada proporcionados como argumentos, y devuelven un valor numérico. ABS, ACOS, ASIN, ATAN, ATN2, CEILING, COS, COT, DEGREES, EXP, FLOOR, LOG, LOG10, PI, POWER, RADIANS, RAND, ROUND, SIGN, SIN, SQRT, SQUARE, TAN, TRUNC
Funciones espaciales Las siguientes funciones espaciales realizan una operación en un valor de entrada de objeto espacial y devuelven un valor numérico o booleano. ST_DISTANCE, ST_INTERSECTS, ST_ISVALID, ST_ISVALIDDETAILED, ST_WITHIN
Funciones de cadena Las siguientes funciones de cadena realizan una operación sobre un valor de entrada de cadena y devuelven una cadena, un valor numérico o un booleano. CONCAT, CONTAINS, ENDSWITH, INDEX_OF, LEFT, LENGTH, LOWER, LTRIM, REGEXMATCHREPLACE, REPLICATE, REVERSE, RIGHT, RTRIM, STARTSWITH, StringToArray, StringToBoolean, StringToNull, StringToNumber, StringToObject, SUBSTRING, ToString, TRIM, UPPER
Funciones de comprobación de tipos Las funciones de comprobación de tipos permiten comprobar el tipo de una expresión dentro de consultas SQL. IS_ARRAY, IS_BOOL, IS_DEFINED, IS_NULL, IS_NUMBER, IS_OBJECT, IS_PRIMITIVE, IS_STRING

Funciones integradas frente a funciones definidas por el usuario (UDF)

Si actualmente usa una función definida por el usuario (UDF) para la que ahora hay disponible una función integrada, la función integrada correspondiente será más rápida de ejecutar y más eficaz.

Funciones integradas frente a funciones de ANSI SQL

La diferencia principal entre las funciones de Cosmos DB y las de ANSI SQL es que las primeras están diseñadas para funcionar bien con datos sin esquemas y con datos de esquemas mixtos. Por ejemplo, si falta una propiedad o tiene un valor no numérico, como undefined, se omite el elemento en lugar de devolver un error.

Pasos siguientes