---
id: yandex-query-client
version: "0.1.4"
license: unclear
license_treatment: permissive
maintenance: dormant
---

# yandex-query-client — The Yandex Query official HTTP client

License: permissive · Maintenance: dormant · Downloads: 3.9M/mo

## What it is and what it does

yandex-query-client is an official HTTP client library for Yandex Query, Yandex Cloud's managed query service. It wraps the REST API to let you submit SQL queries, poll for completion, and fetch results with column names and types. The client handles authentication via IAM tokens and manages the query lifecycle—creation, waiting for success, and result retrieval—abstracting away direct HTTP calls.

The package depends on pandas, python-dateutil, requests, and urllib3 to handle data serialization and HTTP transport. It targets Python 3.8 and later. Maintenance is dormant as of mid-2024, so the library is stable but not actively developed; use it if you need to integrate Yandex Query into a Python application, but do not expect ongoing updates or support for new Yandex Cloud features.

Use it for:

- Submit ad-hoc SQL queries to Yandex Query from a Python script and retrieve results programmatically.
- Automate data extraction pipelines that query Yandex Cloud data warehouses and process results locally.
- Build a thin wrapper around Yandex Query for batch analytics jobs that need to run SQL and consume output.
- Integrate Yandex Query into a larger data processing workflow alongside pandas and other Python tools.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

HTTP client for submitting SQL queries to Yandex Query service and retrieving results with column metadata.

Yes, if you are already committed to Yandex Cloud and need to query Yandex Query from Python. The package is lightweight, has no security vulnerabilities, and uses standard dependencies. However, dormant maintenance means no active development; install it only if the current API surface meets your needs and you can tolerate no future updates.

## Install

pip install yandex-query-client
uv add yandex-query-client
poetry add yandex-query-client

## Installing yandex-query-client

Before you install: Low install friction with standard dependencies. Maintenance is dormant—last commit was 2024-06-19 and no releases since 2024-05-10—so expect no active bug fixes or feature updates.

License in practice: MIT license (permissive) allows use, modification, and distribution with minimal restrictions.

Quickstart:

pip install yandex-query-client

from yandex_query_client import YQHttpClient, YQHttpClientConfig

config = YQHttpClientConfig(IAM_TOKEN, PROJECT_ID)
client = YQHttpClient(config)
query_id = client.create_query(query_text="select 777", name="my query")
result_set_count = client.wait_query_to_succeed(query_id)
results = client.get_query_all_result_sets(query_id, result_set_count=result_set_count)

Requires valid Yandex Cloud IAM token and folder ID to authenticate and execute queries.

Verify before relying:

- Whether the package handles query timeouts or provides configurable wait/retry behavior.
- Error handling and exception types raised by the client for failed queries or network issues.
- Support for parameterized queries or prepared statements to prevent injection.
- Whether results are automatically converted to pandas DataFrames or returned in raw format.

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: dormant
- Downloads: 3.9M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

yandex query client, yandex cloud sql api, query execution client, sql query submission, yandex query results, yandex-cloud, sql-client

[View on SkillFed](https://skillfed.io/packages/yandex-query-client) · [View on PyPI](https://pypi.org/project/yandex-query-client/)