Dimension Attribute Properties Reference

Applies to: SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium

In Microsoft SQL Server SQL Server Analysis Services, there are many properties that determine how dimensions and dimension attributes function. The following table lists and describes each of these attribute properties.

Property Description
AttributeHierarchyDisplayFolder Identifies the folder in which to display the associated attribute hierarchy to end users.
AttributeHierarchyEnabled Determines whether an attribute hierarchy is generated by SQL Server Analysis Services for the attribute. If the attribute hierarchy is not enabled, the attribute cannot be used in a user-defined hierarchy and the attribute hierarchy cannot be referenced in Multidimensional Expressions (MDX) statements.
AttributeHierarchyOptimizedState Determines the level of optimization applied to the attribute hierarchy. By default, an attribute hierarchy is FullyOptimized, which means that SQL Server Analysis Services builds indexes for the attribute hierarchy to improve query performance. The other option, NotOptimized, means that no indexes are built for the attribute hierarchy. Using NotOptimized is useful if the attribute hierarchy is used for purposes other than querying, because no additional indexes are built for the attribute. Other uses for an attribute hierarchy can be helping to order another attribute.
AttributeHierarchyOrdered Determines whether the associated attribute hierarchy is ordered. The default value is True. However, if an attribute hierarchy will not be used for querying, you can save processing time by changing the value of this property to False.
AttributeHierarchyVisible Determines whether the attribute hierarchy is visible to client applications. The default value is True. However, if an attribute hierarchy will not be used for querying, you can save processing time by changing the value of this property to False.
CustomRollupColumn Specifies the column that defines a custom rollup formula.
CustomRollupPropertiesColumn Specifies the column that contains the properties of a custom rollup formula.
DefaultMember Specifies a Multidimensional Expressions (MDX) expression that defines the default measure for the attribute.
Description Contains the description of the attribute.
DiscretizationBucketCount Contains the number of buckets into which to discretize.
DiscretizationMethod Defines the method to use for discretization.
EstimatedCount Specifies the estimated number of members in the attribute. Until you run the Aggregation Design Wizard, the default value is zero. Either you can allow the wizard to count the number of records or you can enter an estimated value. Enter a value manually if you know the number of members and want to save the time that is required to query the database for the count. If you are working with a test subset of your production data, you can use the counts of your production data so that the aggregation design will be optimized for the production data instead of the test data.
GroupingBehavior A user defined value that provides a hint to client applications on how to group attributes.
ID Contains the unique identifier (ID) of the dimension.
InstanceSelection Provides a hint to client applications about how a list of items should be displayed, based on the expected number of items in the list. The available options are as follows:

None No hint is provided to the client application. This is the default value.

DropDown The number of items is small enough to display in a drop-down list.

List The number of items is too large for a drop-down list, but does not require filtering.

FilteredList The number of items is large enough to require users to filter the items to be displayed.

MandatoryFilter The number of items is so large that the display must always be filtered.
IsAggregatable Specifies whether the values of the attribute members can be aggregated. The default value is True, which means that the attribute hierarchy contains an (All) level. If the value for this property is False, the attribute hierarchy does not contain an (All) level.
KeyColumns Contains the column or columns that represent the key for the attribute, which is the column in the underlying relational table in the data source view to which the attribute is bound. The value of this column for each member is displayed to users unless a value is specified for the NameColumn property.
MemberNamesUnique Determines whether member names in the attribute hierarchy must be unique.
MembersWithData Used by parent attributes to determine whether to display data members for non-leaf members in the parent attribute. This property value is only used when the value of the Usage property is set to Parent. This means that a parent-child hierarchy has been defined. The available options are as follows:

NonLeafDataHidden Non-leaf data is hidden.

NonLeafDataVisible Non-leaf data is visible.
MembersWithDataCaption Provides a template string that is used by parent attributes to create captions for system-generated data members in the parent attribute. This property value is only used when the value of the Usage property is set to Parent. This means that a parent-child hierarchy has been defined.
Name Contains the user-friendly name of the attribute.
NameColumn Identifies the column that provides the name of the attribute that is displayed to users, instead of the value in the key column for the attribute. This column is used when the key column value for an attribute member is cryptic or not otherwise useful to the user, or when the key column is based on a composite key. The NameColumn property is not used in parent-child hierarchies; instead, the NameColumn property for child members is used as the member names in a parent-child hierarchy.
NamingTemplate Defines how levels are named in a parent-child hierarchy constructed from the parent attribute. This property value is only used when the value of the Usage property is set to Parent. This means that a parent-child hierarchy has been defined.
OrderBy Describes how to order the members that are contained in the attribute hierarchy. The default value is Name, which specifies that ordering of the attribute members is based on the value of the NameColumn property, if any. Otherwise, members are ordered by the value of the key column. The available options are as follows:

NameColumn Order by the value of the NameColumn property.

Key Order by the value of the key column of the attribute member.

AttributeKey Order by the value of the member key of a specified attribute, which must have an attribute relationship to the attribute.

AttributeName Order by the value of the member name of a specified attribute, which must have an attribute relationship to the attribute.
OrderByAttribute Identifies the attribute by which to order the members of the attribute hierarchy.
RootMemberIf Determines how the root or topmost members of a parent-child hierarchy are identified. This property value is only used when the value of the Usage property is set to Parent. This means that a parent-child hierarchy has been defined. The default value is ParentIsBlankSelfOrMissing, which means that only members that meet one or more of the conditions described for ParentIsBlank, ParentIsSelf, or ParentIsMissing are treated as root members. The following values are also available:

ParentIsBlank Only members with a null, a zero, or an empty string in the key column or columns are treated as root members.

ParentIsSelf Only members with themselves as parents are treated as root members.

ParentIsMissing Only members with parents that cannot be found are treated as root members.
Type Contains the type of the attribute. For more information, see Configure Attribute Types.
UnaryOperatorColumn Specifies the column that provides unary operators. It is a binding of DataItem type that defines the details of a column providing a unary operator.
Usage Describes how an attribute is used.

The available options are as follows:

Regular The attribute is a regular attribute. This is the default value.

Key The attribute is a key attribute.

Parent The attribute is a parent attribute.
ValueColumn Identifies the column that provides the value of the attribute. If the NameColumn element of the attribute is specified, the same DataItem values are used as default values for the ValueColumn element. If the NameColumn element of the attribute is not specified and the KeyColumns collection of the attribute contains a single KeyColumn element representing a key column with a string data type, the same DataItem values are used as default values for the ValueColumn element.

Note

For more information about how to set values for the KeyColumn property when you are working with null values and other data integrity issues, see Handling Data Integrity Issues in Analysis Services 2005.

Note

The default member on an attribute is used to evaluate expressions when a member from the hierarchy is not explicitly included in a query. The default member for an attribute is specified by the DefaultMember property on the attribute. Whenever a hierarchy from a dimension is included in a query, all the default members from attributes corresponding to levels in the hierarchy are ignored. If no hierarchy of a dimension is included in a query, then default members are used for all the attributes in the dimension. For more information on default members, see Define a Default Member.

See Also

Attributes and Attribute Hierarchies