告别 DDL 难题：使用 Skapi 的零设置关系数据库 API

数据库是现代服务的命脉。从用户账户到交易记录，能够保存和检索关系数据是动态应用程序得以实现的关键。

但编写 DDL 脚本并非人人皆知。就我个人而言，我们从来不喜欢编写 SQL 模式、定义约束、映射类、匹配数据类型、管理 NOT NULL 以及连接外键来构建一个功能齐全的相关数据网络。

这正是 Skapi 的用武之地。我们提供各种工具，其中包括一个高性能数据库，即用型，无需设置。只需按照本分步指南将您的项目连接到 Skapi 服务，5 分钟内即可使用我们强大的数据库以及更多功能。

在本文中，我们将概述我们的数据库方法。如何创建、获取、更新记录以及创建表。

要在 Skapi 数据库中创建新记录，您需要使用我们的postRecord()方法。由于www.tymbjy.com能够直接处理 FormData，您可以通过标签onsubmit上的函数来执行此操作<form>；或者，如果您希望对对象的数据结构进行更多控制，也可以从 JavaScript 中调用该函数。

对于 HTML 表单：

ini 复制代码

<form onsubmit="skapi.postRecord(event, { table: { name: 'my_collection', access_group: 'public' } })">
    <input name="something" placeholder="Say something" value="Hello World" />
    <input type="submit" value="Submit" />
</form>

对于 Javascript：

css 复制代码

// Data to be saved in key:value pairs
let data = {
    something: "Hello World"
}

// Configuration for the record to be uploaded
let config = {
    table: { name: 'my_collection', access_group: 'public' }
}

skapi.postRecord(data, config);

您会注意到，在两种情况下都需要发送两个主要对象：和data。config的data含义不言而喻，它是您需要保存到数据库的任何内容，包括文件。但是，才是config您开始利用我们数据库的众多功能的地方。

让我们从最基本的table配置开始。

在这里，您可以为数据库设置一个表，但您会注意到，您无需编写任何 SQL 语句或匹配数据类型。没错，Skapi 会自动为您创建新表。

当你发布一条新记录时，它会自动检查表配置，并在数据库中搜索匹配的表并插入该记录。但如果不存在匹配的表，它会创建一个新表来存储你的数据。

让我们来看看具体操作方法：

在前面的例子中，我们用表 config 创建了一条记录name: 'my collection'

css 复制代码

let data = {
    something: "Hello World"
}

let config = {
    table: { name: 'my_collection', access_group: 'public' }
}

skapi.postRecord(data, config);

现在我们向同一张表中添加第二条记录，如下所示：

css 复制代码

let data = {
    something: "This is the new data"
}

let config = {
    table: { name: 'my_collection', access_group: 'public' }
}

skapi.postRecord(data, config);

Skapi 会自动检测表格是否存在，并将新数据添加到同一张表中。如果您愿意，可以通过按表筛选来获取数据。

为了讨论如何获取数据，让我们探索一下如何使用该getRecords()方法。

css 复制代码

let query = {
    table: { name: 'my_collection',
    access_group: 'public'
}

skapi.getRecords(query);

这将返回一个响应，其中list包含RecordData"my_collection"表中所有公共对象的对象。

现在，RecordData它包含了您设置的所有数据，以及 Skapi 自动设置的一些其他重要属性，例如属性record_id。有了它，您可以直接引用单个记录，这对于每个应用程序的功能都至关重要。以下是使用从单个记录中获取数据的方法record_id: 1234：

ini 复制代码

let query = {
    record_id: 1234
}

skapi.getRecords(query);

这将返回一个响应，其中list包含一个包含所选记录数据的 Json 对象。

另一个需要用到的重要功能record_id是更新现有记录。方法很简单，只需使用postRecord()函数，并将字符串添加record_id到config对象中即可。我先来演示一下如何使用record_id: 1234之前的函数来更新记录。

css 复制代码

let data = {
    something: "New data"
}

let config = {
    record_id: 1234;
    table: { name: 'my_collection', access_group: 'public' }
}

skapi.postRecord(data, config);

我们完成了，您的记录已使用新数据更新。

如您所见，Skapi 非常易于使用。您可以立即开始使用我们的数据库，无需构建自定义架构和后端 API 的大量开销。