Weaviate объявила GraphQL API устаревшим: отключение в Cloud завершится 1 мая 2027 года

26 октября 2026 года Weaviate объявила GraphQL API устаревшим. В этот день существующие интеграции продолжают работать, но компания назначила сроки отключения интерфейса в Weaviate Cloud. Для самостоятельного размещения предусмотрен отдельный график.

• 1 декабря 2026 года: GraphQL отключат в Cloud-кластерах, которые не использовали его последние 30 дней. Если интерфейс всё же нужен, компания предлагает обратиться в поддержку для переноса отключения.
• 1 мая 2027 года: GraphQL отключат во всех оставшихся Cloud-кластерах. Новые кластеры уже создаются без него.
• Самостоятельное размещение: первый минорный релиз после 1 мая 2027 года отключит GraphQL по умолчанию, сохранив возможность включить его обратно. Дата полного удаления пока не определена.

Какие интеграции нужно проверить

Миграция затрагивает прямые обращения к /v1/graphql, вызовы вроде graphql_raw_query() и старые клиентские библиотеки. Среди них — Python v3, weaviate-ts-client v2, Java v5 и Go v5 или более ранние версии. Зависимость может скрываться и внутри сторонней интеграции LangChain, LlamaIndex либо BI-инструмента.

Рекомендуемая замена — актуальные официальные клиенты с поиском через gRPC; для Go нужен клиент v6. В браузерах и edge-средах доступен @weaviate/web через gRPC-Web. При этом даже современные Python- и TypeScript-клиенты могут использовать GraphQL для агрегаций на серверах старше Weaviate v1.29.0 — это отдельно отмечено в руководстве по миграции.

Почему REST не всегда заменяет GraphQL

REST Search API остаётся в Preview: поля запросов и ответов могут измениться, а документация пока не рекомендует его для production. В нём отсутствуют, например, встроенная RAG-генерация, rerank и статистики свойств при агрегации. Неизвестные поля могут молча игнорироваться, поэтому успешного HTTP-ответа недостаточно для проверки переноса.

Некоторые функции GraphQL пока вообще не имеют замены ни в клиентах, ни в gRPC, ни в REST: среди них Explore, spellCheck и возможности модулей qna, sum-transformers и ner-transformers. Для таких зависимостей Weaviate предлагает обращаться в поддержку.

Практическая проверка — запуск приложения на тестовом экземпляре с DISABLE_GRAPHQL=true. Отключённые GraphQL-эндпоинты возвращают HTTP 422 с сообщением graphql api is disabled. В Cloud раннее отключение для проверки можно запросить через поддержку.