Перейти к содержанию

digna CLI Reference 2024.12

2024-12-09

На этой странице задокументирован полный набор команд CLI digna релиза 2024.12, включая примеры использования и параметры.

2024-12-09

Основы CLI

Использование опции --help

Опция --help предоставляет информацию о доступных командах и их использовании. Существует два основных способа использования этой опции:

  1. Отобразить общую справку:

    Используйте --help сразу после ключевого слова dignacli

    dignacli --help

  2. Получить справку по конкретной команде:

    Для получения подробной информации о конкретной команде добавьте --help к этой команде. Например, чтобы получить справку по команде add-user, выполните: 

    dignacli add-user --help

    ### вывод:

    • Описание команды: Подробно описывает, что делает команда.
    • Синтаксис: Показывает точный синтаксис, включая обязательные и необязательные аргументы.
    • Параметры: Перечисляет параметры команды и их объяснения.
    • Примеры: Приводит примеры эффективного выполнения команды.

Использование команды check-repo-connection

Команда check-repo-connection — утилита внутри CLI digna, предназначенная для проверки доступности и подключения к указанному репозиторию digna. Эта команда проверяет, может ли CLI взаимодействовать с репозиторием.

Использование команды

dignacli check-repo-connection

После успешного выполнения команда выводит подтверждение подключения и сведения о репозитории: версия репозитория, хост, база данных и схема.

Если соединение с репозиторием не устанавливается, проверьте файл config.toml на предмет корректных настроек.

Использование команды version

Чтобы узнать установленную версию dignacli, используйте опцию --version.

Использование команды

dignacli --version

Пример вывода

dignacli version 2024.12

Использование опций логирования

По умолчанию вывод в консоль команд digna минималистичен. Большинство команд позволяют получить дополнительную информацию с помощью следующих опций:

--verbose (-v)
--debug (-d)
--logfile (lf)

«verbose» и «debug» задают уровень детализации, тогда как переключатель «logfile» позволяет перенаправлять вывод в файл вместо отображения в консоли.

Управление пользователями

Использование команды add-user

Команда add-user в CLI digna используется для добавления нового пользователя в систему digna.

Использование команды

dignacli add-user [OPTIONS] USER_NAME USER_FULL_NAME USER_PASSWORD

Аргументы

  • USER_NAME: Имя пользователя для нового аккаунта (обязательно).
  • USER_FULL_NAME: Полное имя нового пользователя (обязательно).
  • USER_PASSWORD: Пароль для нового пользователя (обязательно).

Параметры

  • --is_superuser, -su: Флаг, обозначающий, что новый пользователь является администратором.
  • --valid_until, -vu: Устанавливает дату истечения срока действия аккаунта в формате YYYY-MM-DD HH:MI:SS. Если не задано, срок действия не ограничен.

Пример

Чтобы добавить нового пользователя с именем jdoe, полным именем John Doe и паролем password123:

dignacli add-user [OPTIONS] USER_NAME USER_FULL_NAME USER_PASSWORD

Чтобы добавить нового пользователя и задать срок истечения аккаунта: 

dignacli add-user jdoe "John Doe" password123 --valid_until "2024-12-31 23:59:59"

Использование команды delete-user

Команда delete-user в CLI digna используется для удаления существующего пользователя из системы digna.

Использование команды

dignacli delete-user USER_NAME

Аргументы

  • USER_NAME: Имя пользователя, которого нужно удалить (обязательно). Это единственный обязательный аргумент команды.

Пример

dignacli delete-user jdoe

Выполнение этой команды удалит пользователя jdoe из системы digna, отзывая его доступ и удаляя связанные с ним данные и права из репозитория.

Использование команды modify-user

Команда modify-user в CLI digna используется для обновления данных существующего пользователя в системе digna.

Использование команды

dignacli modify-user <USER_NAME> <USER_FULL_NAME> [options]

Аргументы

  • USER_NAME: Имя пользователя, которого нужно изменить (обязательно).
  • USER_FULL_NAME: Новое полное имя пользователя (обязательно).

Параметры

  • --is_superuser, -su: Делает пользователя суперпользователем, предоставляя повышенные привилегии. Этот флаг не требует значения.
  • --valid_until, -vu: Устанавливает дату истечения срока действия аккаунта в формате YYYY-MM-DD HH:MI:SS. Если не задано, аккаунт остается действительным бесконечно.

Пример

Чтобы изменить полное имя пользователя jdoe на «Johnathan Doe» и назначить ему суперпользователя: 

dignacli modify-user jdoe "Johnathan Doe" --is_superuser

Использование команды modify-user-pwd

Команда modify-user-pwd в CLI digna используется для смены пароля существующего пользователя в системе digna.

Использование команды

dignacli modify-user-pwd <USER_NAME> <USER_PWD>

Аргументы

  • USER_NAME: Имя пользователя, чей пароль необходимо изменить (обязательно).
  • USER_PWD: Новый пароль для пользователя (обязательно).

Пример

Чтобы сменить пароль пользователя jdoe на newpassword123: 

dignacli modify-user-pwd jdoe newpassword123

Использование команды list-users

Команда list-users в CLI digna отображает список всех пользователей, зарегистрированных в системе digna.

Использование команды

dignacli list-users

Выполнение этой команды в CLI digna подключится к репозиторию digna и покажет всех пользователей, отображая их ID, имя пользователя, полное имя, статус суперпользователя и временные метки истечения срока действия.

Управление репозиториями

Использование команды upgrade-repo

Команда upgrade-repo в CLI digna используется для обновления или инициализации репозитория digna. Эта команда необходима для применения обновлений или настройки инфраструктуры репозитория при первом запуске.

Использование команды

dignacli upgrade-repo [options]

Параметры

  • --simulation-mode, -s: При включении этот параметр запускает команду в режиме симуляции, который выводит SQL-запросы, которые были бы выполнены, но не выполняет их фактически. Это полезно для предварительного просмотра изменений без внесения модификаций в репозиторий.

Пример

Чтобы обновить репозиторий digna, можно запустить команду без параметров:

dignacli upgrade-repo
Чтобы выполнить обновление в режиме симуляции (просмотреть SQL-запросы без их применения):

dignacli upgrade-repo --simulation-mode

Эта команда важна для поддержки системы digna, обеспечивая соответствие схемы базы данных и других компонентов репозитория последней версии ПО.

Использование команды encrypt

Команда encrypt в CLI digna используется для шифрования пароля.

Использование команды

dignacli encrypt <PASSWORD>

Аргументы

  • PASSWORD: Пароль, который необходимо зашифровать (обязательно).

Пример

Чтобы зашифровать пароль, необходимо передать пароль в виде аргумента.
Например, чтобы зашифровать пароль mypassword123, используйте: 

dignacli encrypt mypassword123
Эта команда выводит зашифрованную версию переданного пароля, которую затем можно использовать в безопасных контекстах. Если аргумент пароля не указан, CLI отобразит ошибку о пропущенном аргументе.

Использование команды generate-key

Команда generate-key используется для генерации ключа Fernet, который необходим для защиты паролей, хранящихся в репозитории digna.

Использование команды

dignacli generate-key

Управление данными

Использование команды clean-up

Команда clean-up в CLI digna используется для удаления профилей, предсказаний и данных системы светофора для одного или нескольких источников данных внутри указанного проекта. Эта команда необходима для управления жизненным циклом данных, помогая поддерживать упорядоченную и эффективную среду данных путем очистки устаревших или ненужных данных.

Использование команды

dignacli clean-up <PROJECT_NAME> <FROM_DATE> <TO_DATE> [options]

Аргументы

  • PROJECT_NAME: Имя проекта, из которого нужно удалить данные (обязательно). Использование ключевого слова all-projects в этом аргументе указывает digna итерироваться по всем существующим проектам и применить команду.
  • FROM_DATE: Начальная дата и время для удаления данных. Допустимые форматы включают %Y-%m-%d, %Y-%m-%dT%H:%M:%S или %Y-%m-%d %H:%M:%S (обязательно).
  • TO_DATE: Конечная дата и время для удаления данных, в тех же форматах, что и FROM_DATE (обязательно).

Параметры

  • --table-name, -tn: Ограничивает операцию очистки конкретной таблицей в проекте.
  • --table-filter, -tf: Фильтр для ограничения очистки таблицами, содержащими указанный подстрок в имени.
  • --timing, -tm: Показывает продолжительность процесса очистки после завершения.
  • --help: Отображает справочную информацию по команде clean-up и выходит.

Пример

Чтобы удалить данные из проекта ProjectA в период с 1 января 2023 года по 30 июня 2023 года:

dignacli clean-up ProjectA 2023-01-01 2023-06-30

Чтобы удалить данные только из конкретной таблицы с именем Table1:

dignacli clean-up ProjectA 2023-01-01 2023-06-30 --table-name Table1

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

Использование команды inspect

Команда inspect в CLI digna используется для создания профилей, предсказаний и данных системы светофора для одного или нескольких источников данных внутри указанного проекта. Эта команда помогает анализировать и мониторить данные за заданный период.

Использование команды

dignacli inspect <PROJECT_NAME> <FROM_DATE> <TO_DATE> [options]

Аргументы

  • PROJECT_NAME: Имя проекта, для которого проводится инспекция данных (обязательно). Использование ключевого слова all-projects в этом аргументе указывает digna итерироваться по всем существующим проектам и применить команду.
  • FROM_DATE: Дата и время начала инспекции данных. Допустимые форматы включают %Y-%m-%d, %Y-%m-%dT%H:%M:%S или %Y-%m-%d %H:%M:%S (обязательно).
  • TO_DATE: Дата и время окончания инспекции данных, в тех же форматах, что и FROM_DATE (обязательно).

Параметры

  • --table-name, -tn: Ограничивает инспекцию конкретной таблицей в проекте.
  • --table-filter, -tf: Фильтрует таблицы для инспекции, оставляя только те, которые содержат указанную подстроку в имени.
  • --do-profile: Запускает повторный сбор профилей. По умолчанию — do-profile.
  • --no-do-profile: Запрещает повторный сбор профилей.
  • --do-prediction: Запускает перерасчет предсказаний. По умолчанию — do-prediction.
  • --no-do-prediction: Запрещает перерасчет предсказаний.
  • --do-alert-status: Запускает перерасчет статусов оповещений. По умолчанию — do-alert-status.
  • --no-do-alert-status: Запрещает перерасчет статусов оповещений.
  • --iterative: Выполняет инспекцию периода с ежедневными итерациями. По умолчанию — iterative.
  • --no-iterative: Выполняет инспекцию всего периода за один проход.
  • --timing, -tm: Показывает продолжительность процесса инспекции после завершения.

Пример

Чтобы просканировать данные проекта ProjectA с 1 января 2024 года по 31 января 2024 года:

dignacli inspect ProjectA 2024-01-01 2024-01-31

Чтобы просканировать только определенную таблицу и принудительно пересчитать предсказания:

dignacli inspect ProjectA 2024-01-01 2024-01-31 --table-name Table1 --force-prediction
Эта команда полезна для генерации обновленных профилей и предсказаний, мониторинга целостности данных и управления системой оповещений в рамках указанного временного интервала проекта.

Использование команды tls-status

Команда tls-status в CLI digna используется для получения статуса Системы Светофора (TLS) для конкретной таблицы в проекте на указанную дату. Система Светофора предоставляет сведения о состоянии и качестве данных, указывая на возможные проблемы или оповещения, требующие внимания.

Использование команды

dignacli tls-status <PROJECT_NAME> <TABLE_NAME> <DATE>

Аргументы

  • PROJECT_NAME: Имя проекта, для которого запрашивается статус TLS (обязательно).
  • TABLE_NAME: Конкретная таблица в проекте, для которой требуется статус TLS (обязательно).
  • DATE: Дата, на которую запрашивается статус TLS, обычно в формате %Y-%m-%d (обязательно).

Пример

Чтобы проверить статус TLS для таблицы UserData в проекте ProjectA на 1 июля 2024 года:

dignacli tls-status ProjectA UserData 2024-07-01

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

Использование команды list-projects

Команда list-projects в CLI digna используется для отображения списка всех доступных проектов в системе digna.

Использование команды

dignacli list-projects

Эта команда особенно полезна администраторам и пользователям, управляющим несколькими проектами, предоставляя быстрый обзор доступных проектов в репозитории digna.

Использование команды list-ds

Команда list-ds в CLI digna используется для отображения списка всех доступных источников данных в указанном проекте. Эта команда полезна для понимания доступных данных для анализа и управления в системе digna.

Использование команды

dignacli list-ds <PROJECT_NAME>

Аргументы

  • PROJECT_NAME: Имя проекта, для которого перечисляются источники данных (обязательно).

Пример

Чтобы перечислить все источники данных в проекте с именем ProjectA:

dignacli list-ds ProjectA

Эта команда предоставляет пользователям обзор источников данных, доступных в проекте, помогая эффективнее ориентироваться и управлять ландшафтом данных.