{"id":13710820,"url":"https://github.com/vertica/vertica-nodejs","last_synced_at":"2025-04-05T23:07:15.484Z","repository":{"id":37444623,"uuid":"505452002","full_name":"vertica/vertica-nodejs","owner":"vertica","description":"Official native node.js client for the Vertica Analytics Database.","archived":false,"fork":false,"pushed_at":"2024-10-24T12:36:26.000Z","size":3981,"stargazers_count":13,"open_issues_count":16,"forks_count":14,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-03-29T22:05:43.025Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://www.vertica.com/","language":"JavaScript","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/vertica.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","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":"2022-06-20T13:25:53.000Z","updated_at":"2024-10-30T20:54:44.000Z","dependencies_parsed_at":"2024-02-07T14:45:46.819Z","dependency_job_id":"2f1864bb-6ecd-4f03-b8de-55854b174cb5","html_url":"https://github.com/vertica/vertica-nodejs","commit_stats":{"total_commits":2383,"total_committers":310,"mean_commits":7.687096774193549,"dds":"0.38984473352916493","last_synced_commit":"c4485b96747bb806f46fe08ac32ae9de70774ce3"},"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vertica%2Fvertica-nodejs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vertica%2Fvertica-nodejs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vertica%2Fvertica-nodejs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vertica%2Fvertica-nodejs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vertica","download_url":"https://codeload.github.com/vertica/vertica-nodejs/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247411231,"owners_count":20934653,"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":[],"created_at":"2024-08-02T23:01:01.143Z","updated_at":"2025-04-05T23:07:15.456Z","avatar_url":"https://github.com/vertica.png","language":"JavaScript","readme":"# vertica-nodejs\n\n[![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg)](https://opensource.org/licenses/Apache-2.0)\n[![NPM version](https://img.shields.io/npm/v/vertica-nodejs?color=blue)](https://www.npmjs.com/package/vertica-nodejs)\n[![NPM downloads](https://img.shields.io/npm/dm/vertica-nodejs)](https://www.npmjs.com/package/vertica-nodejs)\n[![test status](https://github.com/vertica/vertica-nodejs/actions/workflows/ci.yml/badge.svg)](https://github.com/vertica/vertica-nodejs/actions/workflows/ci.yml)\n\nNon-blocking Vertica client for Node.js made with pure Javascript. This client has been tested with Vertica 24.4.0 and Node 12/14/16/18/20.\n\n## Documentation\n\nThis monorepo contains the core vertica-nodejs module as well as a handful of related modules. Each individual package should have its own documentation with more specific information designed to help develop with the full capabilities of the driver.\n- [vertica-nodejs](https://github.com/vertica/vertica-nodejs/tree/master/packages/vertica-nodejs)\n- [v-pool](https://github.com/vertica/vertica-nodejs/tree/master/packages/v-pool)\n- [v-connection-string](https://github.com/vertica/vertica-nodejs/tree/master/packages/v-connection-string)\n- [v-protocol](https://github.com/vertica/vertica-nodejs/tree/master/packages/v-protocol)\n\n## Features\n\n- Pure JavaScript client\n- Connection pooling\n- Extensible JS ↔ Vertica data-type coercion\n\n## Contributing\n\nWe will gladly accept external pull requests if they are well documented and contain tests. \nFor more information on how to contribute, check out our [contributing guidelines](https://github.com/vertica/vertica-nodejs/blob/master/CONTRIBUTING.md)\n\n## Installation\nTo install vertica-nodejs with npm: \n  `npm install vertica-nodejs`\n\n## Post Installation Setup \n\nThe current version of the driver is routinely tested against Node v14. It is recommended to install this version of node in your application environment. \n\nEnsure that you have an active Vertica server.\n\nEnsure that the applicable environment variables are configured for connecting to your Vertica server. These are the variables and the default values used if not set:\n\n - V_HOST: 'localhost'\n - V_PORT: 5433\n - V_USER: process.env.USER/USERNAME\n - V_PASSWORD: ''\n - V_DATABASE: ''\n - V_BACKUP_SERVER_NODE: ''\n\n Once these are done, you should be able to run the examples found in the examples directory noted in the next section. Simply download or copy the example javascript file(s) and execute them in a node environment.\n \n For example, to execute the basic.js file all you need to do is run `node basic.js`\n\n \u003c!-- Once we have an example for testing your configured environment, make note of that here instead of using the basic.js example. --\u003e\n\n## Examples\n\nSee the [examples directory](https://github.com/vertica/vertica-nodejs/tree/master/examples) for sample applications showing how to use the vertica-nodejs client driver. Other usage examples can be found in the documentation of each individual package.\n\n## Vertica Data Types\n\nSee [DATATYPES.md](https://github.com/vertica/vertica-nodejs/blob/master/DATATYPES.md) to view the mappings from type IDs to Vertica data types.\n\n## Setting up for local driver development\n\nThe following instructions are for working with the driver source code. Follow this set up if you intend to contribute to the driver. These steps are similar to those for developing with the driver, but include steps for building and testing locally. \n\n1. Clone the repo\n2. If yarn is not already installed, install yarn `npm install -g yarn`\n3. From your workspace root run `yarn` and then `yarn lerna bootstrap`\n4. Ensure you have a Vertica instance running with \n5. Ensure you have the proper environment variables configured for connecting to the instance (`V_HOST`, `V_PORT`, `V_USER`, `V_PASSWORD`, `V_DATABASE`, `V_BACKUP_SERVER_NODE`)\n6. Run `yarn test` to run all the tests, or run `yarn test` from within an individual package to only run that package's tests\n\nIf using VS Code, you can install the `Remote - Containers` extension and it will use the configuration under the `.devcontainer` folder to automatically create dev containers, including Vertica.  See [here](https://code.visualstudio.com/docs/remote/containers) for more information on developing in containers using VS Code.  This process will complete steps 3 to 5 above.\n\n## Support\n\nvertica-nodejs is free software. If you encounter a bug with the library please open an issue on the [GitHub repo](https://github.com/vertica/vertica-nodejs). If you have questions unanswered by the documentation please open an issue pointing out how the documentation was unclear and we will address it as needed. \n\nWhen you open an issue please provide:\n\n- version of Node\n- version of Vertica\n- smallest possible snippet of code to reproduce the problem\n\n## Troubleshooting and FAQ\n\nThe causes and solutions to common errors can be found among the [Frequently Asked Questions (FAQ)](https://github.com/vertica/vertica-nodejs/wiki/FAQ)\n\n## License\n\nApache 2.0 License, please see [LICENSE](https://github.com/vertica/vertica-nodejs/blob/master/LICENSE) for details.\n","funding_links":[],"categories":["Clients"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvertica%2Fvertica-nodejs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvertica%2Fvertica-nodejs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvertica%2Fvertica-nodejs/lists"}