ClickHouse / ClickHouse/clickhouse-java

Query Parameters Refactor

Abierto
#1,517 4 comentarios 3 reacciones 0 asignados Ver en GitHub
action:verify area:docs client-api-v2 enhancement
Lenguaje dominante
Java
Estrellas
1.6k
Forks
637
Merge medio
2 d 23 h
PR fusionados (30 d)
29

Descripción

**Description:**

In the current implementation, clickhouse-java manually parses query parameters, supporting both traditional question marks and named parameters. We propose refactoring this process to leverage ClickHouse's [parameters binding capabilities](https://clickhouse.com/docs/en/sql-reference/syntax#defining-and-using-query-parameters) for a more streamlined and efficient parameter parsing.

This refactoring aligns with the methods used by other connectors, including:

- [Python client](https://github.com/ClickHouse/clickhouse-connect/blob/6928aed5845c944007b6bf93e806313a96a93fbc/clickhouse_connect/driver/query.py#L370)
- [JS client](https://github.com/ClickHouse/clickhouse-js/blob/bc310bb529763d503ec75609d2b569956ad3b73f/packages/client-common/src/utils/url.ts#L65)
- [Go client](https://github.com/ClickHouse/clickhouse-go/blob/main/query_parameters.go#L33)

All of these clients have comprehensive test suites ([Python](https://github.com/ClickHouse/clickhouse-connect/blob/99681d98eeb2106a54c298a6d320906977d3e4cc/tests/integration_tests/test_params.py), [JS](https://github.com/ClickHouse/clickhouse-js/blob/927ca276d4d41d44e6b36b4315c5143a3467258a/packages/client-common/__tests__/unit/format_query_params.test.ts), and [Go](https://github.com/ClickHouse/clickhouse-go/blob/main/tests/query_parameters_test.go)) that can serve as valuable references for testing the proposed refactoring.

Guía de contribución

Abrir la guía de contribución

Línea de trabajo

Comienza con la implementación actual del análisis y binding de parámetros de consulta en clickhouse-java; el issue no nombra archivos locales. Compara el comportamiento con Python query.py, JS url.ts y Go query_parameters.go, y usa después los archivos de prueba de parámetros enlazados como referencia. Se considera terminado cuando los parámetros tradicionales y con nombre se gestionan mediante ClickHouse binding y existe la cobertura de pruebas Java correspondiente.

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

Evaluación

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

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.