Función SAMPLE (DAX)

  • Artículo

Devuelve una muestra de N filas de la tabla especificada.

Sintaxis

SAMPLE(<n_value>, <table>, <orderBy_expression>, [<order>[, <orderBy_expression>, [<order>]]…])

Parámetros

  • n_value
    Número de filas que se va a devolver. Es cualquier expresión de DAX que devuelva un único valor escalar, con el que la expresión se va a evaluar varias veces (para cada fila y contexto). Si se especifica un valor (o expresión) no entero, el resultado se convierte a entero.

  • tabla
    Cualquier expresión DAX que devuelve una tabla de datos de donde extraer las 'n' filas de muestra.

  • orderBy_expression
    (Opcional) Cualquier expresión de DAX escalar en la que el valor del resultado se evalúa para cada fila de table.

  • order
    (Opcional) Valor que especifica cómo ordenar los valores de orderBy_expression, en orden ascendente o descendente:

    value

    valor alternativo

    Descripción

    0 (cero)

    FALSE

    Ordena en orden descendente de valores de order_by.

    Es el valor predeterminado si se omite el parámetro order.

    1

    TRUE

    Ordena de forma ascendente los valores de order_by.

Valor devuelto

Una tabla que consta de una muestra de N filas de table o una tabla vacía si n_value es 0 (cero) o menos. Si se proporcionan argumentos OrderBy, la muestra será estable y determinista, y devuelve la primera fila, la última y las filas equitativamente distriuidas entre ellas. Si no se especifica un orden, la muestra será aleatoria, no estable y no determinista.

Comentarios

  • Si n_value es 0 (cero) o menos, SAMPLE devuelve una tabla vacía.

  • Para evitar valores duplicados en la muestra, la tabla proporcionada como segundo argumento debe agruparse por la columna usada para la ordenación.