接入数据源

绝大多数后台系统的作用是用来管理和操作你的数据,比如用来管理订单的订单管理系统,用户审核系统,或者员工管理系统。

因此,使用卡拉云的第一步就是将对应的数据源接入。在卡拉云中,接入数据源非常简单,你只需要简单地配置几个选项,就可以接入任何数据源。

我们原生支持市面上主流的数据库和几乎所有 API,更多的集成还在持续增加中。目前卡拉云支持的数据库和 API 有

  • MySQL
  • MongoDB
  • PostgreSQL
  • REST API
  • 阿里云 API REST 接口
  • LeanCloud REST API 接口

在接入数据源后,你就可以在应用中将数据源与应用通过查询连接起来,开发出得心应手的工具来交付给运营、产品或者运维日常使用。关于查询,我们将在之后的文档中详细讨论。

添加一个数据源

要在卡拉云中添加一个数据源,只需要在主界面上,点击 数据源 按钮,即可以进入数据源页面。点击 添加数据源,按说明将需要的字段填入,即可将卡拉云与数据源连接上。

数据源列表

数据源类型

在添加数据源时,请选择正确的数据源类型,比如如果你的数据库是 MySQL 那么在添加时请选择 MySQL 数据库,而如果是 PostgreSQL 则选择对应的 PostgreSQL 数据源类型。

接入 MySQL 数据源

在添加 SQL 类型的数据源时(包括 MySQL 或 PostgreSQL),你需要指定以下几个配置

  • 数据源名称 - 方便你区分数据源,比如“订单数据库“
  • Host 地址 - 数据库的 Host 地址,如果你是自建数据库,则是一个 IP 地址,如果你用的是托管的云端数据库,则是一串域名地址
  • 数据库名 - 数据库的名字,请注意这是在配置数据库时设置的数据库名
  • 数据库用户名 - 访问数据库的用户名,如 root
  • 数据库密码 - 对应数据库的密码
  • 端口号 - 数据库端口号,默认 MySQL 是 3306,而 Postgres 默认端口为 5432

在输入好配置后,点 测试连接 按钮,卡拉云会尝试验证配置是否正确,如果配置正确则会提示测试连接成功。

📘
将卡拉云加入白名单
注意为了保证卡拉云可以连接你的数据库,如果你使用的是托管的数据库,你可能需要将卡拉云的 IP 地址 60.205.169.231 添加到白名单内,否则从应用内无法连接你的数据。在配置好数据库后,建议先测试连接,保证数据库连接通畅

接入 PostgreSQL 数据源

接入 PostgreSQL 的步骤与 MySQL 几乎一模一样,你只需要在添加数据源类型时选择 PostgreSQL 即可

接入 REST API 数据源

如果你需要接入一个 REST API,那么在创建数据源时,选择 RESTful API 类型,同时填入以下两个配置即可

  • 数据源名称 - 任意名称,方便你区分数据源
  • API 端点 - 即 API 的前缀

对于 API 端点,你只需要将端点前缀填入即可。比如如果你需要用以下几个接口

POST https://jsonplaceholder.typicode.com/photos
GET https://jsonplaceholder.typicode.com/photos
GET https://jsonplaceholder.typicode.com/photos/:photoId

那么端点可以是 https://jsonplaceholder.typicode.com/ 而后面的具体端点名称可以在应用内配置。

注: REST API 无法验证连接,但你可以在应用内直接尝试请求验证

👍
保证数据源安全
只有管理员帐户权限可以添加和修改数据源,因此如果对数据安全有要求,建议将管理员权限限制在少部分受信用户手中。卡拉云本身不存储任何数据,任何请求的数据只是经过卡拉云的服务器,而不会被查看或存储,以保证你的用户安全。

常见连接问题

如果在连接 MySQL 和 PostgreSQL 等数据库里返回错误,请检查以下情况

  1. 数据库 Host 是否正确,是否存在末尾多加了空格的情况
  2. 确认数据库的帐号密码是否设置正确
  3. 确认数据库名是否为数据库的名称 (即在 MySQL 运行 show databases 时出现的数据库名,或在 Postgres 中运行 \list 时出现的数据库名)
  4. 端口是否正确
  5. 是否将卡拉云 IP 地址 60.205.169.231 加入了白名单中