Управление конфигурацией топиков 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 |
string required |
Имя топика |
database_endpoint |
string required |
Полный путь до базы данных |
retention_period_ms |
number optional |
Длительность хранения данных в миллисекундах, значение по умолчанию — 86400000 (сутки) |
partitions_count |
number optional |
Количество партиций, значение по умолчанию — 2 |
supported_codecs |
list(string) optional |
Поддерживаемые кодеки сжатия данных, значение по умолчанию — "gzip", "raw", "zstd" ,можно использовать их комбинации |
consumer |
consumer |
Читатели для топика |
Примечание
Читателя (consumer) можно создать, используя Terraform, но нельзя удалить. Читателя можно удалить в консоли управления
Описание читателя данных (consumer
Название поля | Тип | Описание |
---|---|---|
name |
string required |
Имя читателя |
supported_codecs |
list(string) optional |
Поддерживаемые кодировки сжатия данных, по умолчанию — "gzip", "raw", "zstd" , можно использовать их комбинации |
starting_message_timestamp_ms |
number optional |
Временная метка в формате UNIX timestamp |