> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> 计算秩相关系数。

# rankCorr

<div id="rankCorr">
  ## rankCorr
</div>

引入版本：v20.9.0

计算秩相关系数。

返回 x 和 y 的秩相关系数。相关系数的取值范围为 -1 到 +1。如果传入的参数少于两个，函数将返回异常。接近 +1 的值表示高度线性相关，即当一个随机变量增加时，另一个随机变量也会增加。接近 -1 的值表示高度线性负相关，即当一个随机变量增加时，另一个随机变量会减少。接近或等于 0 的值表示两个随机变量之间没有相关关系。

**另请参见**

* [斯皮尔曼秩相关系数](https://en.wikipedia.org/wiki/Spearman%27s_rank_correlation_coefficient)

**语法**

```sql theme={null}
rankCorr(x, y)
```

**参数**

* `x` — 任意值。[`Float*`](/zh/reference/data-types/float)
* `y` — 任意值。[`Float*`](/zh/reference/data-types/float)

**返回值**

返回 x 和 y 的秩之间的秩相关系数。取值范围为 -1 到 +1。[`Float64`](/zh/reference/data-types/float)

**示例**

**完全相关**

```sql title=Query theme={null}
SELECT rankCorr(number, number) FROM numbers(100);
```

```response title=Response theme={null}
┌─rankCorr(number, number)─┐
│                        1 │
└──────────────────────────┘
```

**非线性关系**

```sql title=Query theme={null}
SELECT roundBankers(rankCorr(exp(number), sin(number)), 3) FROM numbers(100);
```

```response title=Response theme={null}
┌─roundBankers(rankCorr(exp(number), sin(number)), 3)─┐
│                                              -0.037 │
└─────────────────────────────────────────────────────┘
```

**另请参阅**

* [斯皮尔曼秩相关系数](https://en.wikipedia.org/wiki/Spearman%27s_rank_correlation_coefficient)
