# Разверните свои метрики

Платформа dbt | Starter, Enterprise, Enterprise+

В этом разделе объясняется, как запустить задание в среде развертывания в dbt, чтобы материализовать и развернуть метрики. В настоящее время поддерживается только среда развертывания.

1. После того как вы [определили семантические модели и метрики](https://docs.getdbt.tech/guides/sl-qs.md?step=6), создайте коммит с изменениями метрик и выполните слияние в своем проекте dbt.

2. В dbt создайте новую [среду развертывания](https://docs.getdbt.tech/docs/deploy/deploy-environments.md#create-a-deployment-environment) или используйте существующую среду с dbt версии 1.6 или выше.

   * Примечание: в настоящее время поддерживается среда развертывания (*поддержка среды разработки появится в ближайшее время*)

3. Чтобы создать новую среду, перейдите в раздел **Orchestration** в меню навигации, выберите **Environments**, а затем — **Create new environment**.

4. Укажите имя пользователя и пароль для вашей платформы данных в учетных данных для развертывания. Схеме можно присвоить любое имя. Нажмите **Save**, чтобы создать новую производственную среду.

5. [Создайте новое задание развертывания](https://docs.getdbt.tech/docs/deploy/deploy-jobs.md#create-and-schedule-jobs), которое будет выполняться в только что созданной среде. Вернитесь в меню **Orchestration**, выберите **Jobs**, затем **Create job** и нажмите **Deploy job**.

6. Настройте задание на выполнение команды `dbt parse`, чтобы разобрать ваши проекты и сформировать файл [артефакта `semantic_manifest.json`](https://docs.getdbt.tech/reference/artifacts/sl-manifest.md)(Версии dbt: v1.12 и новее) и [артефакт `osi_document.json`](https://docs.getdbt.tech/reference/artifacts/sl-manifest.md#apache-ossie-document). Хотя выполнение `dbt build` не требуется, при необходимости вы можете запустить эту команду.

   примечание

   Если вы используете dbt v2, добавьте команду `dbt docs generate` в свое задание, чтобы успешно развернуть метрики.

7. Запустите job, нажав кнопку **Run now**. Отслеживайте прогресс выполнения в реальном времени на вкладке **Run summary**.

   После успешного завершения задания ваш проект dbt, включая сгенерированную документацию, будет полностью развернут и доступен для использования в вашей производственной среде. Если возникнут какие-либо проблемы, просмотрите логи, чтобы диагностировать и устранить ошибки.

Что происходит внутри?

* Слияние кода с вашей основной веткой позволяет dbt получить эти изменения и сформировать определение в манифесте, созданном в результате запуска.
  <br />
* Повторный запуск задания в среде развертывания помогает материализовать модели, от которых зависят метрики, на платформе данных. Это также обеспечивает актуальность манифеста.
  <br />
* API семантического слоя получают самый свежий манифест и позволяют вашей интеграции извлекать из него метаданные.

## Следующие шаги

После того как вы выполнили задание и развернули Semantic Layer:

* [Настройте Semantic Layer](https://docs.getdbt.tech/docs/use-dbt-semantic-layer/setup-sl.md) в dbt.
* Ознакомьтесь с [доступными интеграциями](https://docs.getdbt.tech/docs/platform-integrations/avail-sl-integrations.md), такими как Tableau, Google Sheets, Microsoft Excel и другими.
* Начните запрашивать метрики, используя [синтаксис запросов API](https://docs.getdbt.tech/docs/dbt-apis/sl-jdbc.md#querying-the-api-for-metric-metadata).

## Связанные документы

* [Оптимизируйте производительность запросов](https://docs.getdbt.tech/docs/use-dbt-semantic-layer/sl-cache.md) с помощью декларативного кэширования.
* [Проверяйте семантические узлы в CI](https://docs.getdbt.tech/docs/deploy/ci-jobs.md#semantic-validations-in-ci), чтобы убедиться, что изменения в коде dbt-моделей не нарушают эти метрики.
* Если вы еще этого не сделали, узнайте, как [создавать ваши метрики и семантические модели](https://docs.getdbt.tech/docs/build/build-metrics-intro.md) в вашем предпочитаемом инструменте разработки.
