# Използване на DATA API за смяна на база данни

> DATA адресира таблица като база/таблица, така че един и същ код за заявки работи с вградения NoSQL и с други бази данни.

Framework: total5
Product: Total.js 5 (total5@0.0.19)
Language: bg
Content-SHA256: a8f28f92670170b61ee9eeed44f4160651eff1fd14befe3bb2f83af399d24975
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: total5-installed@total5@0.0.19
Review: not-recorded

`DATA` е независима от базата данни входна точка към query builder. Първият аргумент е `driver/table`; `nosql/people` означава „вградената NoSQL база данни, таблица `people`“. Методите на builder (`where`, `sort`, `take`, `callback`) са същите като при `NOSQL()`, така че кодът на вашите действия остава същият, ако по-късно смените драйвера.

| Извикване | Какво прави |
|---|---|
| `DATA.insert(table, doc)` | вмъква документ |
| `DATA.find(table)` | връща builder за списък |
| `DATA.read(table)` | връща builder за един документ |
| `DATA.update(table, data)` | обновява документи |
| `DATA.remove(table)` | премахва документи |

```js definitions/people.js
NEWACTION('People/insert', {
	name: 'Insert a person',
	input: '*name:String, age:Number',
	action: function($, model) {
		model.id = UID();
		DATA.insert('nosql/people', model).callback(() => $.success(model.id));
	}
});

NEWACTION('People/query', {
	name: 'List people',
	query: 'sort:Lowercase',
	action: function($) {
		DATA.find('nosql/people').sort($.query.sort || 'name_asc').callback((err, response) => $.callback(response));
	}
});

NEWACTION('People/rename', {
	name: 'Rename a person',
	params: '*id:UID',
	input: '*name:String',
	action: function($, model) {
		DATA.update('nosql/people', { name: model.name }).where('id', $.params.id).callback((err, count) => $.success(count));
	}
});
```

```js controllers/people.js
exports.install = function() {
	ROUTE('POST /people/ --> *People/insert');
	ROUTE('GET /people/ --> *People/query');
	ROUTE('PATCH /people/{id}/ --> *People/rename');
};
```