The translation is temporarily closed for contributions due to maintenance, please come back later.
The translation was automatically locked due to following alerts: Could not merge the repository.
Zen

Source string Source string

48/10000 · 48
English Actions
Writing data [5 minutes]
We will write data to the Tarantool cluster using the CRUD module. You don't have to specify the shard you want to read from or write to -- the module does it for you.
**Important:** All cluster operations must be performed only on the router and using the CRUD module.
Let's connect the CRUD module in the code and write three procedures:
User creation
Adding a video
Liking a video
The procedures must be described in a special file. To do this, go to the "Code" tab. Create a new directory called ``extensions``, and in this directory, create the file ``api.lua``.
Paste the code below into ``api.lua`` and click "Apply".
local cartridge = require('cartridge')
local crud = require('crud')
local uuid = require('uuid')
local json = require('json')

function add_user(request)
local fullname = request:post_param("fullname")
local result, err = crud.insert_object('users', {user_id = uuid.new(), fullname = fullname})
if err ~= nil then
return {body = json.encode({status = "Error!", error = err}), status = 500}
end

return {body = json.encode({status = "Success!", result = result}), status = 200}
end

function add_video(request)
local description = request:post_param("description")
local result, err = crud.insert_object('videos', {video_id = uuid.new(), description = description})
if err ~= nil then
return {body = json.encode({status = "Error!", error = err}), status = 500}
end

return {body = json.encode({status = "Success!", result = result}), status = 200}
end

function like_video(request)
local video_id = request:post_param("video_id")
local user_id = request:post_param("user_id")

local result, err = crud.insert_object('likes', {like_id = uuid.new(),
video_id = uuid.fromstr(video_id),
user_id = uuid.fromstr(user_id)})
if err ~= nil then
return {body = json.encode({status = "Error!", error = err}), status = 500}
end

return {body = json.encode({status = "Success!", result = result}), status = 200}
end

return {
add_user = add_user,
add_video = add_video,
like_video = like_video,
}
Setting up HTTP API [2 minutes]
Clients will visit the Tarantool cluster using the HTTP protocol. The cluster already has a built-in HTTP server.
To configure HTTP paths, you need to write a configuration file. Go to the "Code" tab. Create the file ``config.yml`` in the ``extensions`` directory, which you created on the last step.
Paste the configuration example below into ``config.yml`` and click "Apply".
---
functions:

add_user:
module: extensions.api
handler: add_user
events:
- http: {path: "/add_user", method: POST}

add_video:
module: extensions.api
handler: add_video
events:
- http: {path: "/add_video", method: POST}

like_video:
module: extensions.api
handler: like_video
events:
- http: {path: "/like_video", method: POST}
...
Done! Let's make test requests from the console.
curl -X POST --data "fullname=Taran Tool" url/add_user
In the requests, substitute ``url`` with the address of your sandbox. The protocol must be strictly HTTP.
For example, if you're following this tutorial with Try Tarantool, this request will look something like this (note that your hash is different):
curl -X POST --data "fullname=Taran Tool" http://artpjcvnmwctc4qppejgf57.try.tarantool.io/add_user
But if you've bootstrapped Tarantool locally, the request will look as follows:
curl -X POST --data "fullname=Taran Tool" http://localhost:8081/add_user
We've just created a user and got their UUID. Let's remember it.
curl -X POST --data "description=My first tiktok" url/add_video
Let's say a user has added their first video with a description. The video clip also has a UUID. Let's remember it, too.
In order to "like" the video, you need to specify the user UUID and the video UUID from the previous steps. Substitute the ellipses in the command below with the corresponding UUIDs:
curl -X POST --data "video_id=...&user_id=..." url/like_video
The result will be something like this:
Test queries in the console
In our example, you can "like" the video as many times as you want. It makes no sense in the real life, but it will help us understand how sharding works -- more precisely, the ``sharding_key`` parameter.
Our ``sharding_key`` for the ``likes`` is ``video_id``. We also specified a ``sharding_key`` for the ``videos`` space. It means that likes will be stored on the same storage as videos. This ensures data locality with regard to storage and allows getting all the information you need in one network trip to Storage.

Loading…

User avatar None

New source string

testing_project / Documentation: getting_started/getting_started_imcp — English

Done! Let's make test requests from the console.
a year ago
Browse all string changes

Things to check

Multiple failing checks

Following checks are failing:
Mismatched colon: Russian, Russian

Reset

Glossary

English English
No related strings found in the glossary.

String information

Flags
read-only
String age
a year ago
Last updated
a year ago
Source string age
a year ago
Translation file
string 92