SUBSTITUTEWITHINDEX

s’applique à :colonne calculéetable calculéemesurecalcul visuel

Retourne une table qui représente un semi-jointure gauche des deux tables fournies en tant qu’arguments. Le point-joint est effectué à l’aide de colonnes communes, déterminées par les noms de colonnes communs et le type de données commun. Les colonnes jointes sont remplacées par une seule colonne dans la table retournée qui est de type entier et contient un index. L’index est une référence dans la table de jointure appropriée en fonction d’un ordre de tri spécifié.

Les colonnes de la table de droite/seconde fournies qui n’existent pas dans la table de gauche/première fournie ne sont pas incluses dans la table retournée et ne sont pas utilisées pour se joindre.

L’index commence à 0 (basé sur 0) et est incrémenté par un pour chaque ligne supplémentaire dans la table de jointure de droite/seconde fournie. L’index est basé sur l’ordre de tri spécifié pour la table de jointure droite/seconde.

Syntaxe

SUBSTITUTEWITHINDEX(<table>, <indexColumnName>, <indexColumnsTable>, [<orderBy_expression>, [<order>][, <orderBy_expression>, [<order>]]…])

Paramètres

Terme	Définition
table	Table à filtrer en effectuant un semi-jointure gauche avec la table spécifiée comme troisième argument (indexColumnsTable). Il s’agit de la table située à gauche du semi-jointure gauche, de sorte que la table retournée inclut les mêmes colonnes que cette table, sauf que toutes les colonnes communes des deux tables seront remplacées par une colonne d’index unique dans la table retournée.
indexColumnName	Chaîne qui spécifie le nom de la colonne d’index qui remplace toutes les colonnes communes dans les deux tables fournies en tant qu’arguments pour cette fonction.
indexColumnsTable	Deuxième table pour le semi-join gauche. Il s’agit de la table sur le côté droit du semi-join gauche. Seules les valeurs présentes dans cette table sont retournées par la fonction. En outre, les colonnes de cette table (basées sur les noms de colonnes) sont remplacées par une colonne d’index unique dans la table retournée par cette fonction.
orderBy_expression	Toute expression DAX où la valeur de résultat est utilisée pour spécifier l’ordre de tri souhaité de la table indexColumnsTable pour générer des valeurs d’index correctes. L’ordre de tri spécifié pour la table indexColumnsTable définit l’index de chaque ligne de la table et cet index est utilisé dans la table retournée pour représenter des combinaisons de valeurs dans indexColumnsTable comme elles apparaissent dans la table fournie comme premier argument de cette fonction.
order	(Facultatif) Valeur qui spécifie comment trier orderBy_expression valeurs, croissant ou décroissant : Valeur : Desc. Valeur alternative : 0(zéro)/FALSE. Trie dans l’ordre décroissant des valeurs de orderBy_expression. Il s’agit de la valeur par défaut lorsque le paramètre order est omis. Valeur : ASC. Valeur alternative : 1/TRUE. Trie par ordre croissant les valeurs orderBy_expression.

Valeur de retour

Table qui inclut uniquement les valeurs présentes dans la table indexColumnsTable et qui a une colonne d’index au lieu de toutes les colonnes présentes (par nom) dans la table indexColumnsTable.

Notes

• Cette fonction ne garantit aucun ordre de tri des résultats.

• Cette fonction n’est pas prise en charge pour une utilisation en mode DirectQuery lorsqu’elle est utilisée dans les colonnes calculées ou les règles de sécurité au niveau des lignes (RLS).