STATISZTIKÁK MEGJELENÍTÉSE

A következőre vonatkozik:yes Databricks SQL check mark yes Databricks Runtime 18 LTS and above

Note

A Databricks Runtime 18 újabb, mint a Databricks Runtime 18.0, 18.1 és 18.2. Azok a funkciók, amelyek korábban később számozott verzióként lettek volna szállítva, mostantól a Databricks Runtime 18-as verziójának dátumozott frissítéseiként jelennek meg. További részletekért lásd: Az egyesített kibocsátási megjegyzések.

Egy tábla optimalizáló statisztikáit adja vissza JSON-dokumentumként, beleértve a táblaszintű statisztikákat és opcionálisan az oszloponkénti statisztikákat.

A Databricks SHOW STATISTICS programozott módon javasolja az optimalizáló statisztikák olvasását. Csak statisztikákat ad vissza, a kiterjesztett DESCRIBE TABLE ... AS JSON. Használjon ANALYZE TABLE ... SZÁMÍTÁSI STATISZTIKÁK (vagy prediktív optimalizálás) a parancs által jelentésekben szereplő statisztikák gyűjtéséhez.

Szükséges engedélyek

Unity Catalog-táblán való futtatáshoz SHOW STATISTICS a következőkre van szükség:

  • USE CATALOG a szülőkatalógusban.
  • USE SCHEMA a szülőséma.
  • SELECT a táblában, vagy a tábla tulajdonjogát.

Syntax

SHOW STATISTICS [ { FROM | IN } ] table_name
    [ FOR COLUMNS column_name [, ...] | FOR ALL COLUMNS ]
    AS JSON

A FROM kulcsszavak nem IN kötelezőek és felcserélhetők.

Parameters

  • table_name

    Azonosítja azt a táblát, amely statisztikai adatokat szeretne jelenteni. A név nem tartalmazhat időbeli specifikációt vagy beállításspecifikációt.

    Ha a tábla nem található, Azure Databricks TABLE_OR_VIEW_NOT_FOUND hibát jelez.

    A nézetek (ideiglenes vagy állandó) nem támogatottak. A nézetre való SHOW STATISTICS meghívás EXPECT_TABLE_NOT_VIEW.NO_ALTERNATIVE. Metaadatok megtekintésére használható DESCRIBE EXTENDED .

  • COLUMNS , ...]

    Minden elnevezett oszlophoz statistics.column_statistics hozzáad egy bejegyzést.

    Ha a táblában nem található névvel ellátott oszlop, a parancs COLUMN_NOT_FOUND.

  • MINDENKINEK COLUMNS

    Hozzáad egy bejegyzést statistics.column_statistics a tábla minden atomi típusú legfelső szintű oszlopához.

    Azok az oszlopok, amelyek adattípusa STRUCT, ARRAY vagy MAP , kizárt, mert az optimalizáló nem gyűjti össze az összetett típusok statisztikáit. A beágyazott mezők nincsenek számba adva.

  • JSON-KÉNT

    Required. Az eredmény egyetlen JSON-formátumban lesz visszaadva STRING.

JSON-formátumú kimenet

A visszaadott JSON-dokumentum a következő sémát használja:

{
  "table_name": "<table_name>",
  "catalog_name": "<catalog_name>",
  "namespace": ["<schema_name>"],
  "schema_name": "<schema_name>",
  "statistics": {
    "size_in_bytes": <bytes>,
    "num_rows": <count>,
    "collection_source": "<collection_source>",
    "created_at": "<created_at_timestamp>",
    "column_statistics": {
      "<column_name>": {
        "min": "<min_value>",
        "max": "<max_value>",
        "distinct_count": <count>,
        "num_nulls": <count>,
        "avg_len": <bytes>,
        "max_len": <bytes>,
        "has_histogram": <boolean>,
        "has_mcv": <boolean>,
        "has_kll_sketch": <boolean>
      }
    }
  }
}

  • statistics.size_in_bytes

    A táblaadatok teljes mérete bájtban, az optimalizáló által ismert módon. Nincs megadva, ha nincsenek táblaszintű statisztikák.

  • statistics.num_rows

    Sorszám, az optimalizáló által ismert módon. null ha nem gyűjtik össze.

  • statistics.collection_source

    A táblázatszintű statisztikák létrehozásának menete. Az alábbiak egyike:

    • Manuális elemzés – összegyűjtve.ANALYZE TABLE ... COMPUTE STATISTICS
    • Automatikus statisztikák – automatikusan összegyűjtve írás közben.
    • Prediktív elemzés – prediktív optimalizálással gyűjtve.
    • Ismeretlen – ismeretlen forrás gyűjti össze.
    • null – nem állnak rendelkezésre táblázatszintű statisztikák.

  • statistics.created_at

    A táblaszintű statisztikák gyűjtésekor ISO 8601 UTC időbélyegként (például 2026-05-29T08:14:24.845Z). null ha nem gyűjtik össze.

  • statistics.column_statistics

    Csak akkor szerepel benne, ha FOR COLUMNS meg FOR ALL COLUMNS van adva. Az egyes kért oszlopokat az oszloponkénti statisztikáihoz rendeli.

    A következő mezők mindig jelen vannak, ha null nem gyűjtik őket:

    • min, max – minimális és maximális értékek, JSON-sztringekként renderelve.
    • distinct_count – különböző értékek száma (NDV).
    • num_nulls – értékek száma NULL .
    • avg_len, max_len – átlagos és maximális értékhossz bájtban.
    • has_histogram – true ha az oszlophoz egyenlő magasságú hisztogram áll rendelkezésre.

    A következő mezők csak akkor jelennek meg, ha a megfelelő vázlatgyűjtemény engedélyezve van, és másként nem jelennek meg:

    • has_mcv – true ha az oszlophoz elérhető a leggyakoribb értékek listája.
    • has_kll_sketch – true ha elérhető kll vázlat az oszlophoz.

Examples

-- Set up a table and collect column statistics.
> CREATE TABLE customer(cust_id INT, name STRING, state STRING) USING parquet;
> INSERT INTO customer VALUES (100, 'Mike', 'AR'), (200, 'Jane', 'CA');
> ANALYZE TABLE customer COMPUTE STATISTICS FOR ALL COLUMNS;

-- Table-level statistics only.
> SHOW STATISTICS FROM customer AS JSON;
 {"table_name":"customer","catalog_name":"spark_catalog",
  "namespace":["default"],"schema_name":"default",
  "statistics":{"size_in_bytes":864,"num_rows":2,
                "collection_source":"Manual Analyze",
                "created_at":"2026-05-29T08:14:24.845Z"}}

-- Per-column statistics for a list of columns.
> SHOW STATISTICS FROM customer FOR COLUMNS cust_id, name AS JSON;
 {"table_name":"customer","catalog_name":"spark_catalog",
  "namespace":["default"],"schema_name":"default",
  "statistics":{"size_in_bytes":864,"num_rows":2,
                "collection_source":"Manual Analyze",
                "created_at":"2026-05-29T08:14:24.845Z",
                "column_statistics":{
                  "cust_id":{"min":"100","max":"200","distinct_count":2,"num_nulls":0,
                             "avg_len":4,"max_len":4,"has_histogram":false,"has_mcv":false},
                  "name":   {"min":"Jane","max":"Mike","distinct_count":2,"num_nulls":0,
                             "avg_len":4,"max_len":4,"has_histogram":false,"has_mcv":false}}}}

-- All atomic top-level columns. STRUCT, ARRAY, and MAP columns are skipped.
> SHOW STATISTICS FROM customer FOR ALL COLUMNS AS JSON;
  • Last updated on