Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

Java SDK: `describeTable()` не возвращает JSON-индексы

Abierto
  • ¿Algo no está bien?
#756 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

@vgvoleg ya está trabajando en esto.

Desde el 9/10/2026.

  • #758 de @vgvoleg — abierto

Evaluación

Dificultad
4/5
Tiempo estimado
3-5 días
Aptitud para principiantes
35/100
Tipo de issue
Error
Claridad
Bastante claro
Estado de actividad
Activo
Stack tecnológico
java
Área
databases

Línea de trabajo

Start in table/src/main/java/tech/ydb/table/impl/BaseSession.java at mapDescribeTable(), which handles only the global, async and unique index kinds, and in table/src/main/java/tech/ydb/table/description/TableIndex.java, whose Type enum has no JSON entry. The protobuf dependency version is set in bom/pom.xml (ydb-proto-api 1.9.6), and the C++ SDK's kGlobalJsonIndex mapping is a reference for the expected shape. Done means a test with a GLOBAL USING json index returns it from getIndexes() with a JSON type and the payload column. The protobuf bump and the design of the new type should be agreed with maintainers first.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

Проблема

Если у таблицы YDB есть индекс GLOBAL USING json, вызов Session.describeTable() возвращает TableDescription, в котором этот индекс отсутствует в getIndexes(). Обычные вторичные индексы той же таблицы отображаются.

Из-за этого по результату describeTable() нельзя получить полное описание индексов таблицы или даже определить, что JSON-индекс существует.

Как воспроизвести

  1. Создать таблицу с JSON-индексом, например:

    CREATE TABLE documents (
    id Uint64 NOT NULL,
    payload JsonDocument NOT NULL,
    INDEX json_idx GLOBAL USING json ON (payload),
    PRIMARY KEY (id)
);

  2. В Java SDK вызвать session.describeTable(path) и проверить result.getValue().getIndexes().

Фактически: json_idx отсутствует в списке индексов. Метод не сообщает об ошибке.

Ожидается: json_idx присутствует в описании таблицы с типом JSON-индекса и индексируемой колонкой payload.

Что видно в исходниках

BaseSession.mapDescribeTable() добавляет в TableDescription только global_index, global_async_index и global_unique_index. В TableIndex.Type отдельного типа для JSON-индекса также нет. Используемый ydb-proto-api версии 1.9.6 не содержит типизированного поля GlobalJsonIndex в TableIndexDescription.

Для сравнения, C++ SDK обрабатывает kGlobalJsonIndex и преобразует его в EIndexType::GlobalJson.

Похоже, Java SDK требуется поддержка JSON-индекса на уровне protobuf-зависимости, модели TableIndex и преобразования ответа describeTable(), а также тест на таблицу с таким индексом.

Версии

  • Анализ исходников: ветка master, 2.4.12-SNAPSHOT.
Lenguaje dominante
Java
Estrellas
53
Forks
41
Merge medio
1 d 13 h
PR fusionados (30 d)
19

Preparar el entorno

Abrir en Codespaces

Inicia el contenedor de desarrollo del proyecto en tu navegador, con tu propia cuenta de GitHub.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de ydb-platform/ydb-java-sdk

Todos los issues de ydb-platform/ydb-java-sdk

Issues similares

Más issues de Java

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.