Get started with Tablestore Node.js SDK - Tablestore - Centro de documentación de Alibaba Cloud

Utilice el SDK de Tablestore para Node.js para ejecutar operaciones del modelo de columnas anchas.

Inicio rápido

Configure el entorno, instale el SDK e inicialice el cliente.

Requisitos previos

Node.js 4.0 o posterior.

Importante
No utilice las versiones de Node.js 12.0 a 12.14 debido a problemas de compatibilidad.
Una herramienta de desarrollo de Node.js.

Instalar el SDK

Ejecute el siguiente comando para instalar el SDK:

npm install tablestore

A continuación se muestran los programas de ejemplo para las operaciones más comunes del modelo de columnas anchas:

Descargue Node.js SDK y revise la carpeta de ejemplos.
Consulte los ejemplos en GitHub.

Configurar las credenciales de acceso

Create an AccessKey para su cuenta de Alibaba Cloud o usuario de RAM y configúrela como variable de entorno para evitar codificar las credenciales directamente en el código.

Reinicie su IDE, terminal, otras aplicaciones de escritorio y servicios en segundo plano después de la configuración para cargar las variables de entorno actualizadas. Para obtener más información sobre otros tipos de credenciales de acceso, consulte Configure access credentials .

Linux

Agregue las variables de entorno al final del archivo ~/.bashrc:

echo "export TABLESTORE_ACCESS_KEY_ID='YOUR_ACCESS_KEY_ID'" >> ~/.bashrc
echo "export TABLESTORE_ACCESS_KEY_SECRET='YOUR_ACCESS_KEY_SECRET'" >> ~/.bashrc

Aplique los cambios:
```
source ~/.bashrc
```

Compruebe las variables de entorno:

echo $TABLESTORE_ACCESS_KEY_ID
echo $TABLESTORE_ACCESS_KEY_SECRET

macOS

Compruebe cuál es su shell predeterminado:
```
echo $SHELL
```

Configure las variables según el tipo de shell que utilice:

Zsh

Agregue las variables de entorno al final del archivo ~/.zshrc:

echo "export TABLESTORE_ACCESS_KEY_ID='YOUR_ACCESS_KEY_ID'" >> ~/.zshrc
echo "export TABLESTORE_ACCESS_KEY_SECRET='YOUR_ACCESS_KEY_SECRET'" >> ~/.zshrc

Aplique los cambios:
```
source ~/.zshrc
```

Compruebe las variables de entorno:

echo $TABLESTORE_ACCESS_KEY_ID
echo $TABLESTORE_ACCESS_KEY_SECRET

Bash

Agregue las variables de entorno al final del archivo ~/.bash_profile:

echo "export TABLESTORE_ACCESS_KEY_ID='YOUR_ACCESS_KEY_ID'" >> ~/.bash_profile
echo "export TABLESTORE_ACCESS_KEY_SECRET='YOUR_ACCESS_KEY_SECRET'" >> ~/.bash_profile

Aplique los cambios:
```
source ~/.bash_profile
```

Compruebe las variables de entorno:

echo $TABLESTORE_ACCESS_KEY_ID
echo $TABLESTORE_ACCESS_KEY_SECRET

Windows

CMD

Establezca las variables de entorno en CMD:

setx TABLESTORE_ACCESS_KEY_ID "YOUR_ACCESS_KEY_ID"
setx TABLESTORE_ACCESS_KEY_SECRET "YOUR_ACCESS_KEY_SECRET"

Reinicie CMD y compruebe los valores:

echo %TABLESTORE_ACCESS_KEY_ID%
echo %TABLESTORE_ACCESS_KEY_SECRET%

PowerShell

Ejecute lo siguiente en PowerShell:

[Environment]::SetEnvironmentVariable("TABLESTORE_ACCESS_KEY_ID", "YOUR_ACCESS_KEY_ID", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("TABLESTORE_ACCESS_KEY_SECRET", "YOUR_ACCESS_KEY_SECRET", [EnvironmentVariableTarget]::User)

Compruebe las variables de entorno:

[Environment]::GetEnvironmentVariable("TABLESTORE_ACCESS_KEY_ID", [EnvironmentVariableTarget]::User)
[Environment]::GetEnvironmentVariable("TABLESTORE_ACCESS_KEY_SECRET", [EnvironmentVariableTarget]::User)

Inicializar el cliente

Inicialice el cliente y liste las tablas para comprobar la conexión.

Importante

El acceso por red pública está deshabilitado de forma predeterminada en las nuevas instancias. Si necesita este tipo de acceso, habilítelo en Network Management.

var TableStore = require('tablestore');

// Replace yourInstanceName with your instance name
var instancename = 'yourInstanceName';
// Replace yourEndpoint with your instance endpoint
var endpoint = 'yourEndpoint';
// Obtain the AccessKey ID and AccessKey Secret from environment variables
var accessKeyId = process.env.TABLESTORE_ACCESS_KEY_ID;
var secretAccessKey = process.env.TABLESTORE_ACCESS_KEY_SECRET;

// Initialize the Tablestore client
var client = new TableStore.Client({
  accessKeyId: accessKeyId,
  secretAccessKey: secretAccessKey,
  endpoint: endpoint,
  instancename: instancename
});

// List all tables in the instance and print to the console
client.listTable({}, function (err, data) {
    if (err) {
        console.log('error:', err);
        return;
    }
    console.log('success:', data);
});

Tipos de datos

Los data types de Tablestore corresponden a los tipos del SDK de Node.js de la siguiente manera.

Tipo de dato de Tablestore	Tipo de dato del SDK de Node.js	Descripción
String	string	Tipo primitivo de JavaScript.
Integer	int64	JavaScript no cuenta con un tipo nativo de entero de 64 bits. El SDK proporciona `int64` mediante `TableStore.Long`.
Double	number	Tipo primitivo de JavaScript.
Boolean	boolean	Tipo primitivo de JavaScript.
Binary	Buffer	Objeto `Buffer` de Node.js para manejar datos binarios.

TableStore.Long convierte valores entre int64 y los tipos number o string de JavaScript:

// Construct int64 from number or string
const valueA = TableStore.Long.fromNumber(1000);
const valueB = TableStore.Long.fromString('2000');

// Convert int64 back to native JavaScript types
const numA = valueA.toNumber();   // 1000
const strA = valueA.toString();   // '1000'

const numB = valueB.toNumber();   // 2000
const strB = valueB.toString();   // '2000'

Preguntas frecuentes

Referencias

Para obtener información sobre el manejo de errores en Tablestore, consulte Node.js SDK error handling.