Управление конфигурацией топиков YDB
Статья создана
Обновлена 21 октября 2024 г.
Для работы с топикамиyandex_ydb_topic.
Примечание
Рекомендуем создавать топик в отдельном каталоге. Топик в корне БД затрудняет читаемость ее структуры.
Описание ресурса yandex_ydb_topic
Пример использования ресурса yandex_ydb_topic:
resource "yandex_ydb_topic" "ydb_topic" {
database_endpoint = yandex_ydb_database_serverless.database1.ydb_full_endpoint # пример подключения к БД
name = "test_dir/test_topic"
supported_codecs = ["zstd"]
consumer {
name = "test-consumer1"
starting_message_timestamp_ms = 0
supported_codecs = ["zstd","raw"]
}
consumer {
name = "test-consumer2"
starting_message_timestamp_ms = 2000
supported_codecs = ["zstd"]
}
consumer {
name = "test-consumer3"
starting_message_timestamp_ms = 0
supported_codecs = ["zstd"]
}
}
Поддерживаются следующие поля:
| Название поля | Тип | Описание |
|---|---|---|
name |
stringrequired |
Имя топика |
database_endpoint |
stringrequired |
Полный путь до базы данных |
retention_period_ms |
numberoptional |
Длительность хранения данных в миллисекундах, значение по умолчанию — 86400000 (сутки) |
partitions_count |
numberoptional |
Количество партиций, значение по умолчанию — 2 |
supported_codecs |
list(string)optional |
Поддерживаемые кодеки сжатия данных, значение по умолчанию — "gzip", "raw", "zstd",можно использовать их комбинации |
consumer |
consumer |
Читатели для топика |
Примечание
Читателя (consumer) можно создать, используя Terraform, но нельзя удалить. Читателя можно удалить в консоли управления
Описание читателя данных (consumer
| Название поля | Тип | Описание |
|---|---|---|
name |
stringrequired |
Имя читателя |
supported_codecs |
list(string)optional |
Поддерживаемые кодировки сжатия данных, по умолчанию — "gzip", "raw", "zstd", можно использовать их комбинации |
starting_message_timestamp_ms |
numberoptional |
Временная метка в формате UNIX timestamp |