快速入门，界面上的使用方式
使用console
- 创建一个Cloud Spanner instance、database、table。
- 添加schema.
- 写入或更新数据
- 查询数据
参考官网
深入，通过Google Cloud SDK的方式操作Spanner
为了在本地、测试、线上等环境通过代码来操作Spanner DB需要进行以下步骤：
下载好Google Cloud SDK
本地开发之前，需要下载并安装Google Cloud SDK，然后就可以使用gcloud工具。gcloud提供了很多Google Cloud Platform的命令行接口。无论是通过命令行、脚本或其他自动化方式，都可以使用gcloud工具执行许多常见的平台任务。
例如，可以使用gcloud 去创建管理以下资源：
- Google Compute Engine virtual machine instances and other resources
- Google Cloud SQL instances
- Google Kubernetes Engine clusters
- Google Cloud Dataproc clusters and jobs
- Google Cloud DNS managed zones and record sets
- Google Cloud Deployment manager deployments
也可以使用gcloud去部署 App Engine 应用，执行任务
更多关于gcloud的功能看官方文档 gcloud Reference
设置你的project为gcloud command-line工具的默认project
命令如下：
gcloud config set project [MY_PROJECT_ID]
验证授权
Cloud Spanner使用 OAuth 2.0做API验证和授权。跑以下命令：
gcloud auth application-default login
或者
gcloud auth login | gmail@address
或者直接
gcloud auth login
它会打开一个类似https://accounts.google.com/o/oauth2/auth?redirect_uri=XXXXXX的谷歌授权页面，直接点击当前用户并且赋予权限即可。但是这个授权方式只使用于本地环境，如果要部署到production环境，需要使用另外一种方式，请参考 Getting credentials for server-centric flow和Setting Up Authentication for Server to Server Production Applications
使用gcloud command-line工具
本地开发环境的授权已经完成，接下来就是正式使用了。
首先验证一下 gcloud command-line 是否可以连接并且操作Cloud Spanner。
gcloud spanner instance-configs list
通过以上命令可以看到project下面的一系列Cloud Spanner instance 配置信息。包含 regional 和 multi-region 配置信息。
更多操作参考gcloud spanner。
代码中使用Cloud Spanner client library操作Spanner DB
查询数据的一个例子:
// Imports the Google Cloud client library
const Spanner = require('@google-cloud/spanner');
/**
* TODO(developer): Uncomment the following lines before running the sample.
*/
// const projectId = 'my-project-id';
// const instanceId = 'my-instance';
// const databaseId = 'my-database';
// Creates a client
const spanner = new Spanner({
projectId: projectId,
});
// Gets a reference to a Cloud Spanner instance and database
const instance = spanner.instance(instanceId);
const database = instance.database(databaseId);
// Reads rows from the Albums table
const albumsTable = database.table('Albums');
const query = {
columns: ['SingerId', 'AlbumId', 'AlbumTitle'],
keySet: {
all: true,
},
};
albumsTable
.read(query)
.then(results => {
const rows = results[0];
rows.forEach(row => {
const json = row.toJSON();
console.log(
`SingerId: ${json.SingerId}, AlbumId: ${json.AlbumId}, AlbumTitle: ${
json.AlbumTitle
}`
);
});
})
.catch(err => {
console.error('ERROR:', err);
})
.then(() => {
// Close the database when finished.
return database.close();
});
除此以外，还支持很多操作：建数据库，建表，对数据的增删改查等等。更多的详情参考以下官网。
- Getting Started with Cloud Spanner in C#
- Getting Started with Cloud Spanner in Go
- Getting Started with Cloud Spanner in Java
- Getting Started with Cloud Spanner in Node.js
- Getting Started with Cloud Spanner in PHP
- Getting Started with Cloud Spanner in Python
- Getting Started with Cloud Spanner in Ruby
- Getting Started with Cloud Spanner in REST
