Kategorien:: Systemfunktionen (Systeminformationen)

SYSTEM$CLIENT_VERSION_INFO¶

Gibt Versionsinformationen zu Snowflake-Clients und -Treibern zurück.

Siehe auch:: Clientversionen und Supportrichtlinie

Syntax¶

SYSTEM$CLIENT_VERSION_INFO()

Copy

Argumente¶

Keine

Rückgabewerte¶

Zeichenfolge, die ein JSON-Array von Objekten enthält. Jedes Objekt enthält Informationen zu einem bestimmten Client oder Treiber, z. B. SnowSQL, den JDBC-Treiber und so weiter.

Jedes JSON-Objekt enthält die folgenden Name/Wert-Paare:

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

Copy

Wobei:

clientId
Interne ID des Clients oder Treibers. Mögliche Werte sind:

DOTNETDriver

GO

JDBC

JSDriver

ODBC

PHP_PDO

PythonConnector

SnowSQL

SQLAPI

clientAppId
Name des Clients oder Treibers. Mögliche Werte sind:

.NET

GO

JDBC

JavaScript

ODBC

PDO

PythonConnector

SnowSQL

SQLAPI

minimumSupportedVersion
Älteste Version des offiziell unterstützten Clients oder Treibers.

minimumNearingEndOfSupportVersion
Version des Clients oder Treibers, die zu Beginn des nächsten Quartals das Ende des Supports (EOS) erreicht.

recommendedVersion
Aktuelle Version des Clients oder Treibers.

deprecatedVersions, _customSupportedVersions_
Nur für den internen Gebrauch.

Nutzungshinweise¶

Wenn Sie es vorziehen, JSON nicht zu verarbeiten, können Sie die Funktionen PARSE_JSON und LATERAL FLATTEN verwenden, um JSON in eine spaltenförmige Ausgabe umzuwandeln.
Sie können auch die WHERE-Klausel verwenden, um Informationen zu einem bestimmten Client oder Treiber zurückzugeben (clientId).

Beispiele¶

Im folgenden Beispiel werden die Versionsinformationen für alle Snowflake-Clients und -Treiber abgerufen: Beachten Sie, dass die Ausgabe zur besseren Lesbarkeit manuell formatiert wurde.

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_": []
  }
]

Das folgende Beispiel gibt die Versionsinformationen für alle Mandanten als Rowset zurück:

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           |                             |                     |
+-----------------+-----------------+-----------------------------+---------------------+

Das folgende Beispiel gibt die Versionsinformationen für den JDBC-Treiber als Rowset zurück:

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              |
+-----------+-----------------+-----------------------------+---------------------+