4.5 KiB
title | description | menu | influxdb3/cloud-serverless/tags | weight | aliases | prepend | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Install the InfluxDB v2 JavaScript client library | Install the Node.js JavaScript client library to write data to InfluxDB Cloud Serverless. |
|
|
100 |
|
|
Install the Node.js JavaScript client library to write data to InfluxDB {{% product-name %}}.
Install Node.js
-
Install Node.js.
-
Ensure that InfluxDB is running and you can connect to it. For information about what URL to use to connect to {{% product-name %}}, see InfluxDB URLs.
-
In your terminal, create a directory for your Node.js project and change to it.
mkdir influx-node-app && cd influx-node-app
-
Enter the following command to generate an npm package for your project.
npm
: the package manager included with Node.js-y
: uses defaults for the package and bypasses prompts
npm init -y
Install TypeScript
Many of the client library examples use TypeScript. Follow these steps to initialize the TypeScript project:
-
Install TypeScript and type definitions for Node.js.
npm i -g typescript && npm i --save-dev @types/node
-
Enter the following command to create a TypeScript configuration (
tsconfig.json
) with default values:tsc --init
-
Run the TypeScript compiler. To recompile your code automatically as you make changes, pass the
--watch, -w
flag to the compiler.tsc --watch
Install dependencies
Use the @influxdata/influxdb-client
JavaScript client library to write data in {{% product-name %}}.
Open a new terminal window and install the @influxdata/influxdb-client
package for querying and writing data:
npm i --save @influxdata/influxdb-client
The @influxdata/influxdb-client-apis
client library package won't work with {{% product-name %}}.
It only works with InfluxDB v2 management APIs.
Configure credentials
The client examples include an env
module for accessing your InfluxDB properties from environment variables or from env.js
.
The examples use these properties to interact with the InfluxDB API.
Set environment variables or update env.js
with your InfluxDB bucket, organization, token, and URL.
export INFLUX_URL=https://{{< influxdb/host >}}
export INFLUX_TOKEN=API_TOKEN
export INFLUX_ORG=ORG_ID
export INFLUX_BUCKET=BUCKET_NAME
Replace the following:
API_TOKEN
: InfluxDB API token with write permission to the bucket.ORG_ID
: InfluxDB organization IDBUCKET_NAME
: the name of the {{% product-name %}} bucket to write to
Next steps
Once you've installed the client library and configured credentials, you're ready to write data.
{{< page-nav next="/influxdb3/cloud-serverless/reference/client-libraries/v2/javascript/nodejs/write/" keepTab=true >}}