Get started with Tablestore Node.js SDK - Tablestore: Central de Documentação do Alibaba Cloud

Início rápido

Configure o ambiente, instale o SDK e inicialize o cliente.

Pré-requisitos

Node.js 4,0 ou superior.

Importante
Não use as versões do Node.js entre 12,0 e 12,14 devido a problemas de compatibilidade.
Uma ferramenta de desenvolvimento Node.js.

Instalar o SDK

Execute o comando a seguir para instalar o SDK:

npm install tablestore

Programas de exemplo para operações comuns do modelo de coluna larga:

Baixe o Node.js SDK e verifique a pasta de exemplos.
Visualize os exemplos no GitHub.

Configurar credenciais de acesso

Crie uma AccessKey para sua conta Alibaba Cloud ou usuário RAM e configure-a como variável de ambiente para evitar codificar as credenciais diretamente no código.

Reinicie sua IDE, terminal, outros aplicativos de desktop e serviços em segundo plano após a configuração para carregar as variáveis de ambiente atualizadas. Para obter mais informações sobre outros tipos de credenciais de acesso, consulte Configurar credenciais de acesso .

Linux

Adicione as variáveis de ambiente ao arquivo ~/.bashrc:

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

Aplique as alterações:
```
source ~/.bashrc
```

Verifique as variáveis de ambiente:

echo $TABLESTORE_ACCESS_KEY_ID
echo $TABLESTORE_ACCESS_KEY_SECRET

macOS

Verifique seu shell padrão:
```
echo $SHELL
```

Configure conforme o tipo de shell:

Zsh

Adicione as variáveis de ambiente ao arquivo ~/.zshrc:

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

Aplique as alterações:
```
source ~/.zshrc
```

Verifique as variáveis de ambiente:

echo $TABLESTORE_ACCESS_KEY_ID
echo $TABLESTORE_ACCESS_KEY_SECRET

Bash

Adicione as variáveis de ambiente ao arquivo ~/.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 as alterações:
```
source ~/.bash_profile
```

Verifique as variáveis de ambiente:

echo $TABLESTORE_ACCESS_KEY_ID
echo $TABLESTORE_ACCESS_KEY_SECRET

Windows

CMD

Defina as variáveis de ambiente no CMD:

setx TABLESTORE_ACCESS_KEY_ID "YOUR_ACCESS_KEY_ID"
setx TABLESTORE_ACCESS_KEY_SECRET "YOUR_ACCESS_KEY_SECRET"

Reinicie o CMD e verifique:

echo %TABLESTORE_ACCESS_KEY_ID%
echo %TABLESTORE_ACCESS_KEY_SECRET%

PowerShell

Execute no 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)

Verifique as variáveis de ambiente:

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

Inicializar o cliente

Inicialize o cliente e liste as tabelas para validar a conexão.

Importante

O acesso pela rede pública é desativado por padrão em novas instâncias. Para usá-lo, ative essa opção em 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 dados

Os tipos de dados do Tablestore correspondem aos tipos do Node.js SDK da seguinte forma.

Tipo de dado do Tablestore	Tipo de dado do Node.js SDK	Descrição
String	string	Tipo primitivo do JavaScript.
Integer	int64	O JavaScript não possui um tipo nativo de inteiro de 64 bits. O SDK fornece `int64` por meio de `TableStore.Long`.
Double	number	Tipo primitivo do JavaScript.
Boolean	boolean	Tipo primitivo do JavaScript.
Binary	Buffer	Objeto `Buffer` do Node.js para manipulação de dados binários.

O TableStore.Long converte entre int64 e os tipos number ou string do 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'

Perguntas frequentes

Referências

Para detalhes sobre o tratamento de erros no Tablestore, consulte Tratamento de erros.