카테고리:: 시스템 함수 (시스템 정보)

SYSTEM$CLIENT_VERSION_INFO¶

Snowflake 클라이언트 및 드라이버의 버전 정보를 반환합니다.

참고 항목:: 클라이언트 버전 및 지원 정책

구문¶

SYSTEM$CLIENT_VERSION_INFO()

Copy

인자¶

없음

반환¶

오브젝트로 구성된 JSON 배열을 포함하는 문자열을 반환합니다. 각 오브젝트에는 SnowSQL, JDBC 드라이버 등 특정 클라이언트와 드라이버에 대한 정보가 포함됩니다.

각 JSON 오브젝트에는 다음 이름/값 페어가 포함됩니다.

{
  "clientId": "DOTNETDriver",
  "clientAppId": ".NET",
  "minimumSupportedVersion": "2.0.9",
  "minimumNearingEndOfSupportVersion": "2.0.11",
  "recommendedVersion": "2.1.5",
  "deprecatedVersions": [],
  "_customSupportedVersions_": []
},

Copy

여기서

clientId
클라이언트 또는 드라이버의 내부 ID입니다. 가능한 값은 다음과 같습니다.

DOTNETDriver

GO

JDBC

JSDriver

ODBC

PHP_PDO

PythonConnector

SnowSQL

SQLAPI

clientAppId
클라이언트 또는 드라이버의 이름입니다. 가능한 값은 다음과 같습니다.

.NET

GO

JDBC

JavaScript

ODBC

PDO

PythonConnector

SnowSQL

SQLAPI

minimumSupportedVersion
가장 오래된 버전의 클라이언트 또는 드라이버가 공식적으로 지원됩니다.

minimumNearingEndOfSupportVersion
다음 분기 초에 지원 종료(EOS)에 도달하는 클라이언트 또는 드라이버 버전입니다.

recommendedVersion
클라이언트 또는 드라이버의 현재 버전입니다.

deprecatedVersions, _customSupportedVersions_
내부 전용입니다.

사용법 노트¶

JSON을 처리하지 않으려면 PARSE_JSON 및 LATERAL FLATTEN 함수를 사용하여 JSON을 열 형식 출력으로 변환할 수 있습니다.
또한 WHERE 절을 사용하여 특정 클라이언트 또는 드라이버(clientId)에 대한 정보를 반환할 수도 있습니다.

예¶

다음 예제에서는 모든 Snowflake 클라이언트 및 드라이버에 대한 버전 정보를 검색합니다. 더 나은 가독성을 위해 출력 형식이 수동으로 지정되었습니다.

SELECT SYSTEM$CLIENT_VERSION_INFO();

Copy

[
  {
    "clientId": "DOTNETDriver",
    "clientAppId": ".NET",
    "minimumSupportedVersion": "2.0.9",
    "minimumNearingEndOfSupportVersion": "2.0.11",
    "recommendedVersion": "2.1.5",
    "deprecatedVersions": [],
    "_customSupportedVersions_": []
  },
  {
    "clientId": "GO",
    "clientAppId": "Go",
    "minimumSupportedVersion": "1.6.6",
    "minimumNearingEndOfSupportVersion": "1.6.9",
    "recommendedVersion": "1.7.1",
    "deprecatedVersions": [],
    "_customSupportedVersions_": [
      "1.1.5"
    ]
  },
  {
    "clientId": "JDBC",
    "clientAppId": "JDBC",
    "minimumSupportedVersion": "3.13.14",
    "minimumNearingEndOfSupportVersion": "3.13.18",
    "recommendedVersion": "3.14.4",
    "deprecatedVersions": [],
    "_customSupportedVersions_": []
  },
  {
    "clientId": "JSDriver",
    "clientAppId": "JavaScript",
    "minimumSupportedVersion": "1.6.6",
    "minimumNearingEndOfSupportVersion": "1.6.9",
    "recommendedVersion": "1.9.2",
    "deprecatedVersions": [],
    "_customSupportedVersions_": []
  },
  {
    "clientId": "ODBC",
    "clientAppId": "ODBC",
    "minimumSupportedVersion": "2.24.5",
    "minimumNearingEndOfSupportVersion": "2.24.7",
    "recommendedVersion": "3.1.4",
    "deprecatedVersions": [],
    "_customSupportedVersions_": []
  },
  {
    "clientId": "PHP_PDO",
    "clientAppId": "PDO",
    "minimumSupportedVersion": "1.2.0",
    "minimumNearingEndOfSupportVersion": "1.2.1",
    "recommendedVersion": "2.0.1",
    "deprecatedVersions": [],
    "_customSupportedVersions_": []
  },
  {
    "clientId": "PythonConnector",
    "clientAppId": "PythonConnector",
    "minimumSupportedVersion": "2.7.3",
    "minimumNearingEndOfSupportVersion": "2.7.7",
    "recommendedVersion": "3.6.0",
    "deprecatedVersions": [],
    "_customSupportedVersions_": []
  },
  {
    "clientId": "SnowSQL",
    "clientAppId": "SnowSQL",
    "minimumSupportedVersion": "1.2.21",
    "minimumNearingEndOfSupportVersion": "1.2.21",
    "recommendedVersion": "1.2.31",
    "deprecatedVersions": [],
    "_customSupportedVersions_": []
  },
  {
    "clientId": "SQLAPI",
    "clientAppId": "SQLAPI",
    "minimumSupportedVersion": "1.0.0",
    "minimumNearingEndOfSupportVersion": "",
    "recommendedVersion": "",
    "deprecatedVersions": [],
    "_customSupportedVersions_": []
  }
]

다음 예제에서는 모든 클라이언트의 버전 정보를 행 세트로 반환합니다.

WITH output AS (
  SELECT
    PARSE_JSON(SYSTEM$CLIENT_VERSION_INFO()) a
)
SELECT
    value:clientAppId::STRING AS client_app_id,
    value:minimumSupportedVersion::STRING AS minimum_version,
    value:minimumNearingEndOfSupportVersion::STRING AS near_end_of_support_version,
    value:recommendedVersion::STRING AS recommended_version
  FROM output r,
    LATERAL FLATTEN(INPUT => r.a, MODE =>'array');

Copy

+-----------------+-----------------+-----------------------------+---------------------+
| CLIENT_APP_ID   | MINIMUM_VERSION | NEAR_END_OF_SUPPORT_VERSION | RECOMMENDED_VERSION |
|-----------------+-----------------+-----------------------------+---------------------|
| .NET            | 2.0.9           | 2.0.11                      | 2.1.5               |
| Go              | 1.6.6           | 1.6.9                       | 1.7.1               |
| JDBC            | 3.13.14         | 3.13.18                     | 3.14.4              |
| JavaScript      | 1.6.6           | 1.6.9                       | 1.9.2               |
| ODBC            | 2.23.5          | 2.24.7                      | 3.1.4               |
| PDO             | 1.2.0           | 1.2.1                       | 2.0.1               |
| PythonConnector | 2.7.3           | 2.7.7                       | 3.6.0               |
| SnowSQL         | 1.2.21          | 1.2.21                      | 1.2.31              |
| SQLAPI          | 1.0.0           |                             |                     |
+-----------------+-----------------+-----------------------------+---------------------+

다음 예제에서는 JDBC 드라이버의 버전 정보를 행 세트로 반환합니다.

WITH output AS (
  SELECT
    PARSE_JSON(SYSTEM$CLIENT_VERSION_INFO()) a
)
SELECT
    value:clientId::STRING AS client_id,
    value:minimumSupportedVersion::STRING AS minimum_version,
    value:minimumNearingEndOfSupportVersion::STRING AS near_end_of_support_version,
    value:recommendedVersion::STRING AS recommended_version
  FROM output r,
    LATERAL FLATTEN(INPUT => r.a, MODE =>'array')
  WHERE client_id = 'JDBC';

Copy

+-----------+-----------------+-----------------------------+---------------------+
| CLIENT_ID | MINIMUM_VERSION | NEAR_END_OF_SUPPORT_VERSION | RECOMMENDED_VERSION |
|-----------+-----------------+-----------------------------+---------------------|
| JDBC      | 3.13.14         | 3.13.18                     | 3.14.4              |
+-----------+-----------------+-----------------------------+---------------------+