Поделиться через


Справочник по системным таблицам рабочих пространств

Это важно

Эта системная таблица находится в общедоступной предварительной версии.

На этой странице объясняется, как использовать системную таблицу рабочих областей для мониторинга рабочих областей в учетной записи Azure Databricks. Каждая строка в таблице представляет последнее известное состояние активной рабочей области в вашей учетной записи, включая метаданные и состояние жизненного цикла.

Эта таблица наиболее полезна при присоединении к другим системным таблицам. Вы можете использовать его для получения статистической статистики по надежности, производительности и затратам в рабочей области в вашей учетной записи.

Замечание

Таблица включает только рабочие пространства в вашей учетной записи. После отмены рабочей области ее строка удаляется из системной таблицы рабочих областей.

Путь к таблице: эта таблица расположена по адресу system.access.workspaces_latest

Схема таблицы рабочих областей

Имя столбца Тип данных Описание Пример
account_id струна Идентификатор учетной записи Databricks 0722779a-fd4e-49c1-a7a6-8417a97cf9ea
workspace_id струна Идентификатор рабочей области Databricks '2274721051152826'
workspace_name струна Понятное для человека имя рабочей области тесто-re-mi
workspace_url струна URL-адрес рабочей области https://dough-re-mi-pizza.cloud.databricks.com/
create_time отметка времени Метка времени создания рабочей области (с точностью до секунд) 2025-03-05 15:47
status перечисление Состояние рабочей области. Для создания рабочей области изначально задано значение PROVISIONING. Продолжайте проверять состояние до тех пор, пока состояние не будет RUNNING. NOT_PROVISIONED, , PROVISIONINGRUNNING, FAILEDBANNED

Примеры запросов

В следующих разделах приведены примеры запросов SQL с помощью системной таблицы рабочих областей.

Какие рабочие области сейчас запущены?

В приведенном ниже запросе показаны все рабочие области, находящиеся в RUNNING текущем состоянии в вашей учетной записи.

SELECT
    workspace_id,
    workspace_name,
    workspace_url,
    create_time
FROM
    system.access.workspaces_latest
WHERE
    status = "RUNNING";

Какие рабочие области имеют самые высокие расходы?

Этот запрос рассчитывает топ 10 рабочих пространств в вашей учетной записи по расходам за последние 30 дней.

WITH
-- apply date filter
usage_with_ws_filtered_by_date AS (
  SELECT
    w.workspace_id,
    w.workspace_name,
    w.workspace_url,
    u.usage_quantity,
    u.usage_unit,
    u.sku_name,
    u.usage_end_time,
    u.cloud
  FROM
    system.billing.usage AS u NATURAL JOIN system.access.workspaces_latest AS w
  WHERE
    u.usage_date > DATE_ADD(CURRENT_DATE(), -30)
),
-- calc list priced usage in USD
prices AS (
  SELECT
    COALESCE(price_end_time, DATE_ADD(current_date, 1)) AS coalesced_price_end_time,
    *
  FROM
    system.billing.list_prices
  WHERE
    currency_code = 'USD'
),
list_priced_usd AS (
  SELECT
    COALESCE(u.usage_quantity * p.pricing.default, 0) as usage_usd,
    u.*
  FROM
    usage_with_ws_filtered_by_date as u
      LEFT JOIN prices AS p
        ON u.sku_name = p.sku_name
        AND u.cloud = p.cloud
        AND u.usage_unit = p.usage_unit
        AND (u.usage_end_time BETWEEN p.price_start_time AND p.coalesced_price_end_time)
)
-- calc total usage in USD
SELECT
  workspace_id,
  workspace_name,
  workspace_url,
  round(sum(usage_usd), 2) AS usage_usd
FROM
  list_priced_usd
GROUP BY
  1,
  2,
  3
ORDER BY
  4 DESC
limit 10;

Какие работы в моем аккаунте являются самыми дорогостоящими?

Этот запрос вычисляет первые 10 самых дорогих заданий в вашей учетной записи за последние 30 дней.

with usage_with_cost AS (
  SELECT
    *,
    t1.usage_quantity * list_prices.pricing.default as list_cost
  FROM system.billing.usage t1
  INNER JOIN system.billing.list_prices list_prices on
      t1.cloud = list_prices.cloud and
      t1.sku_name = list_prices.sku_name and
      t1.usage_start_time >= list_prices.price_start_time and
      (t1.usage_end_time <= list_prices.price_end_time or list_prices.price_end_time is null)
),
most_expensive_jobs_30d AS (
  SELECT
    workspace_id,
    usage_metadata.job_id,
    SUM(list_cost) as list_cost
  FROM usage_with_cost
  WHERE
    usage_metadata.job_id IS NOT NULL
    AND usage_date >= CURRENT_DATE() - INTERVAL 30 DAYS
  GROUP BY ALL
  ORDER BY list_cost DESC
  LIMIT 100
),
latest_jobs AS (
  SELECT
    *,
    ROW_NUMBER() OVER (PARTITION BY workspace_id, job_id ORDER BY change_time DESC) as rn
  FROM system.lakeflow.jobs QUALIFY rn=1
)
SELECT
  t1.workspace_id,
  t2.workspace_name,
  t3.name as job_name,
  CONCAT(
    t2.workspace_url, '/jobs/', t1.job_id
  ) as job_url,
  t1.list_cost
FROM most_expensive_jobs_30d t1
LEFT JOIN  system.access.workspaces_latest t2 using (workspace_id)
LEFT JOIN latest_jobs t3 USING (workspace_id, job_id)
ORDER BY list_cost DESC
LIMIT 10;