cluster-dmx.md

title	description	author	ms.author	ms.reviewer	ms.date	ms.service	ms.subservice	ms.topic	ms.custom
Cluster (DMX)	Cluster (DMX)	minewiskan	owend	owend	02/17/2022	sql	analysis-services	reference	dmx

Cluster (DMX)

[!INCLUDEssas]

Returns the cluster that is most likely to contain the input case.

Syntax

  
Cluster()  

Applies To

This function can be used only if the underlying data mining model supports clustering.

Return Type

The Cluster function does not require parameters.

The Cluster function returns a scalar value of a cluster name. However, if you use this function as an argument of another function, you must regard it as a <cluster column reference>.

Remarks

Cluster can also be used as a <cluster column reference> for a PredictHistogram function.

Examples

The following example uses a singleton query with the PredictHistogram (DMX) and Cluster functions to return the distance of the individual case from each cluster of the TM Clustering mining model and the probability that the individual case will exist in each cluster.

SELECT  
  PredictHistogram(Cluster())  
FROM  
  [TM Clustering]  
  NATURAL PREDICTION JOIN  
(SELECT 28 AS [Age],  
  '2-5 Miles' AS [Commute Distance],  
  'Graduate Degree' AS [Education],  
  0 AS [Number Cars Owned],  
  0 AS [Number Children At Home]) AS t  

See Also

ClusterProbability (DMX)
Data Mining Extensions (DMX) Function Reference
Functions (DMX)
General Prediction Functions (DMX)