{"id":21306914,"url":"https://github.com/datagrip/couchbase-jdbc-driver","last_synced_at":"2025-07-11T21:31:50.507Z","repository":{"id":47103446,"uuid":"276626899","full_name":"DataGrip/couchbase-jdbc-driver","owner":"DataGrip","description":"Minimal implementation of JDBC Driver for Couchbase","archived":false,"fork":false,"pushed_at":"2023-10-11T12:55:29.000Z","size":17041,"stargazers_count":14,"open_issues_count":0,"forks_count":6,"subscribers_count":2,"default_branch":"dev","last_synced_at":"2025-04-06T09:24:49.579Z","etag":null,"topics":["couchbase","jdbc"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DataGrip.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"license.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-07-02T11:20:12.000Z","updated_at":"2024-03-26T19:33:13.000Z","dependencies_parsed_at":"2024-11-21T16:36:24.576Z","dependency_job_id":"57f7de34-7c96-4da2-9911-624943f6b23a","html_url":"https://github.com/DataGrip/couchbase-jdbc-driver","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/DataGrip/couchbase-jdbc-driver","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DataGrip%2Fcouchbase-jdbc-driver","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DataGrip%2Fcouchbase-jdbc-driver/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DataGrip%2Fcouchbase-jdbc-driver/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DataGrip%2Fcouchbase-jdbc-driver/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DataGrip","download_url":"https://codeload.github.com/DataGrip/couchbase-jdbc-driver/tar.gz/refs/heads/dev","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DataGrip%2Fcouchbase-jdbc-driver/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264902527,"owners_count":23681083,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["couchbase","jdbc"],"created_at":"2024-11-21T16:28:51.180Z","updated_at":"2025-07-11T21:31:50.051Z","avatar_url":"https://github.com/DataGrip.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Couchbase N1QL JDBC Driver\n\nThis driver supports the Couchbase N1QL query language with some extensions for basic bucket management. \n\n## How to build jar\n```\n# Linux, MacOs\n./gradlew jar\n\n# Windows\ngradlew.bat jar\n```\n\nYou'll find it in build/libs.\n\n## JDBC connection string\n\n```\njdbc:couchbase:\u003chost1[:port1],host2[:port2],...\u003e[/defaultBucket][?\u003cproperty1\u003e=\u003cvalue\u003e\u0026\u003cproperty2\u003e=\u003cvalue\u003e\u0026...]\n```\n\nThe driver supports a custom Couchbase port mapping, and the specified port should be a key-value service port [11210 by default].\n\nIf you are connecting to a pre Couchbase 6.5 cluster, a `defaultBucket` must be specified in order to properly initialize the connection.\n\nRecognized properties are the following:\n  * Recognized by the driver itself\n      * `user=\u003cusername\u003e` [required parameter]\n      * `password=\u003cpassword\u003e` [required parameter]\n      * `sslenabled=true/false`\n      * `meta.sampling.size=\u003cinteger\u003e` specifies a number of documents fetched in order to infer a database schema\n      * `query.scan.consistency=not_bounded/request_plus` specifies a query scan consistency (RYW consistency) [default value is `not_bounded`]\n      * `loggingLevel` [default value is `severe`]\n  * Propagated to a Couchbase cluster\n      * The full list of recognized parameters is documented in the Couchbase [Client-Settings Documentation](https://docs.couchbase.com/java-sdk/current/ref/client-settings.html).\n      Any client setting with a system property name may also be specified as a connection string parameter (without the com.couchbase.env. prefix).\n\n\n## Extended N1QL statements\n\nThis driver supports some extra statements for the N1QL query language. These are for a bucket (keyspace) management (create and drop). \nImportant note: create bucket statement is valid for Couchbase Enterprise edition only.\n\n#### Create bucket statement\n```\ncreate-bucket ::= CREATE ( BUCKET | TABLE ) [ WITH PRIMARY INDEX ] keyspace-ref [ bucket-with ] \nkeyspace-ref ::= [ namespace ':' ] keyspace\nbucket-with ::= WITH expr\n```\nWhere `expr` is a json object with optional bucket settings:\n  * `flushEnabled` true/false [default is false]\n  * `ramQuotaMB` number [default is 100]\n  * `replicaNumber` number [default is 1]\n  * `replicaIndexes` true/false [default is false]\n  * `maxTTL` number of seconds [default is 0]\n  * `compressionMode` string, one of \"off\"/\"passive\"/\"active\" [default is passive]\n  * `bucketType` string, one of \"membase\"/\"memcached\"/\"ephemeral\" [default is membase]\n  * `conflictResolutionType` string, one of \"lww\"/\"seqno\" [default is seqno]\n  * `evictionPolicy` string, one of \"fullEviction\"/\"valueOnly\"/\"nruEviction\"/\"noEviction\" [default is based on a bucket type]\n\nIf `WITH PRIMARY INDEX` clause is present, a default primary index will be built for the newly created bucket.\n\nExample:\n```\ncreate bucket with primary index bucket_name \n    with { ramQuotaMB: 128, bucketType: \"ephemeral\" }\n```\n#### Drop bucket statement\n```\ndrop-bucket ::= DROP ( BUCKET | TABLE ) keyspace-ref\nkeyspace-ref ::= [ namespace ':' ] keyspace\n```\n\nExample:\n```\ndrop bucket bucket_name\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdatagrip%2Fcouchbase-jdbc-driver","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdatagrip%2Fcouchbase-jdbc-driver","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdatagrip%2Fcouchbase-jdbc-driver/lists"}