INFORMAÇÃO. ANOTAÇÕES

Aplica-se a: coluna calculada tabela calculada consulta DAX de cálculo visual

Retorna uma tabela com informações sobre cada anotação no modelo semântico. Essas informações ajudam você a entender o modelo.

Sintaxe

INFO.ANNOTATIONS ( [<Restriction name>, <Restriction value>], ... )

Parâmetros

Os parâmetros são opcionais para essa função de DAX. Quando os parâmetros são usados, ambos devem ser dados. Mais de um par de parâmetros é permitido. O nome e o valor da restrição são texto e inseridos entre aspas duplas.

Prazo Definição
Nome da restrição Nome da restrição usada para filtrar os resultados.
Valor de restrição Valor usado para filtrar os resultados da restrição.

Restrições

Normalmente, todas as colunas dos resultados da função DAX podem ser usadas como uma restrição. Restrições adicionais também podem ser permitidas.

Valor de retorno

Uma tabela com as seguintes colunas:

Coluna Descrição
[ID] Uma referência ao objeto. As IDs geralmente são geradas automaticamente e não devem ser alteradas após a criação do modelo. O tipo de dados é sem sinal longo (4 bytes).
[ObjectID] Uma referência ao objeto que possui essa Anotação.
[ObjectType] Uma referência ao tipo de objeto que possui essa Anotação.
[Nome] O nome do objeto, usado em código, script e consultas.
[Valor] O valor da anotação.
[ModifiedTime] A hora em que o objeto foi modificado pela última vez.

Observações

Só pode ser executado por usuários com permissão de gravação no modelo semântico e não quando conectado ao modelo semântico no Power BI Desktop. Essa função pode ser usada em consultas DAXe não pode ser usada em cálculos.

Exemplo 1 – consulta DAX

A consulta DAX a seguir pode ser executada no modo de exibição de consulta DAX:

EVALUATE
	INFO.ANNOTATIONS()

Essa consulta DAX retorna uma tabela com todas as colunas dessa função DAX.

Exemplo 2 – DAX consulta com junções

A consulta DAX a seguir pode ser executada no modo de exibição de consulta DAX:

EVALUATE
	VAR _ObjectTypeEnum =
	DATATABLE(
	"ObjectType",INTEGER,
	"Object",STRING,
	{
	{0,"Null"},
	{1,"Model"},
	{2,"DataSource"},
	{3,"Table"},
	{4,"Column"},
	{5,"AttributeHierarchy"},
	{6,"Partition"},
	{7,"Relationship"},
	{8,"Measure"},
	{9,"Hierarchy"},
	{10,"Level"},
	{11,"Annotation"},
	{12,"KPI"},
	{13,"Culture"},
	{14,"ObjectTranslation"},
	{15,"LinguisticMetadata"},
	{29,"Perspective"},
	{30,"PerspectiveTable"},
	{31,"PerspectiveColumn"},
	{32,"PerspectiveHierarchy"},
	{33,"PerspectiveMeasure"},
	{34,"Role"},
	{35,"RoleMembership"},
	{36,"TablePermission"},
	{37,"Variation"},
	{38,"Set"},
	{39,"PerspectiveSet"},
	{40,"ExtendedProperty"},
	{41,"Expression"},
	{42,"ColumnPermission"},
	{43,"DetailRowsDefinition"},
	{44,"RelatedColumnDetails"},
	{45,"GroupByColumn"},
	{46,"CalculationGroup"},
	{47,"CalculationItem"},
	{48,"AlternateOf"},
	{49,"RefreshPolicy"},
	{50,"FormatStringDefinition"}
	}
	)

	VAR _INFO =
	INFO.ANNOTATIONS()

	VAR _CombinedTable =
	NATURALLEFTOUTERJOIN(
		_INFO,
		_ObjectTypeEnum
	)

	VAR _ModelObjects =
	UNION(
		SELECTCOLUMNS(
			INFO.MEASURES(),
			"ObjectID", [ID],
			"Object Name", [Name]
		),
		SELECTCOLUMNS(
			INFO.TABLES(),
			"ObjectID", [ID],
			"Object Name", [Name]
		),
		SELECTCOLUMNS(
			INFO.COLUMNS(),
			"ObjectID", [ID],
			"Object Name", [ExplicitName]
		),
		SELECTCOLUMNS(
			INFO.EXPRESSIONS(),
			"ObjectID", [ID],
			"Object Name", [Name]
		),
		SELECTCOLUMNS(
			INFO.MODEL(),
			"ObjectID", [ID],
			"Object Name", [Name]
		)
	)

	VAR _CombinedTable2 =
	NATURALLEFTOUTERJOIN(
		_CombinedTable,
		_ModelObjects
	)

	RETURN
		SELECTCOLUMNS(
			_CombinedTable2,
			"Object type", [Object],
			"Object", [Object Name],
			"Annotation name", [Name],
			"Annotation value", [Value]
		)
	ORDER BY [Annotation name]

Essa consulta DAX retorna uma tabela com apenas as colunas especificadas e a junção a outras funções DAX INFO e à tabela de enumeração.

Enumerações

As colunas retornadas nesta função INFO fornecem a ID de uma enumeração ou tabela de pesquisa. Aqui estão os valores de cada enumeração nesta função DAX.

ObjectType

Número Valor
0 Zero
1 Modelo
2 DataSource
3 Mesa
4 Coluna
5 AttributeHierarchy
6 Partição
7 Relação
8 Medir
9 Hierarquia
10 Nível
11 Anotação
12 KPI
13 Cultura
14 ObjectTranslation
15 LinguisticMetadata
29 Perspectiva
30 PerspectiveTable
31 PerspectiveColumn
32 PerspectiveHierarchy
33 PerspectiveMeasure
34 Papel
35 RoleMembership
36 TablePermission
37 Variação
38 Pôr
39 PerspectiveSet
40 ExtendedProperty
41 Expressão
42 ColumnPermission
43 DetailRowsDefinition
44 RelatedColumnDetails
45 GroupByColumn
46 CalculationGroup
47 CalculationItem
48 AlternateOf
49 RefreshPolicy
50 FormatStringDefinition

Esta tabela se baseia na documentação oficial .

Para ingressar com as funções INFO, use essa consulta DAX.

EVALUATE
	DATATABLE(
	"ObjectType",INTEGER,
	"Object",STRING,
	{
	{0,"Null"},
	{1,"Model"},
	{2,"DataSource"},
	{3,"Table"},
	{4,"Column"},
	{5,"AttributeHierarchy"},
	{6,"Partition"},
	{7,"Relationship"},
	{8,"Measure"},
	{9,"Hierarchy"},
	{10,"Level"},
	{11,"Annotation"},
	{12,"KPI"},
	{13,"Culture"},
	{14,"ObjectTranslation"},
	{15,"LinguisticMetadata"},
	{29,"Perspective"},
	{30,"PerspectiveTable"},
	{31,"PerspectiveColumn"},
	{32,"PerspectiveHierarchy"},
	{33,"PerspectiveMeasure"},
	{34,"Role"},
	{35,"RoleMembership"},
	{36,"TablePermission"},
	{37,"Variation"},
	{38,"Set"},
	{39,"PerspectiveSet"},
	{40,"ExtendedProperty"},
	{41,"Expression"},
	{42,"ColumnPermission"},
	{43,"DetailRowsDefinition"},
	{44,"RelatedColumnDetails"},
	{45,"GroupByColumn"},
	{46,"CalculationGroup"},
	{47,"CalculationItem"},
	{48,"AlternateOf"},
	{49,"RefreshPolicy"},
	{50,"FormatStringDefinition"}
	}
	)

Consulte também