Skip to main content

Basic Document Tasks

You can perform basic document tasks such as create, read, update, and delete (CRUD) on documents in a collection. This portion of the tutorial guides you through those tasks. We will first review the syntax of CRUD commands and then use SDKs to send queries to Macrometa platform.

Create the Characters Collection​

Before we can insert documents with SQL, we need a place to put them in: a collection.

For this tutorial, Create a Document Collection in the console. For more information about collections, refer to Collections.

  1. Log in to your Macrometa account.
  2. Click Data > Collections.
  3. Click New Collection.
  4. Click Document.
  5. Name the collection categories and then click Create.

Working with Dataset​

Imagine an online store where we need to put all our products in categories. Initially, we are adding categories to the empty collection. In some cases, we will need to update existing categories or remove some of them. We are doing all the aforementioned operations so that we could have specific data on request.

Add One Document to the Collection​

Add one document to the collection with a query.

Classic SQL syntax:

INSERT INTO categories (_key,name) VALUES('0','Books')

Add Multiple Documents to the Collection​

Add one multiple documents to the collection with a query.

We can json strings(we don't specify any columns):

INSERT INTO categories VALUES ('{\"_key\":\"1\",\"name\":\"Electronics\"}'),('{\"_key\":\"2\",\"name\":\"Food\"}')

Update One Document in the Collection​

Update one document in the collection with a query.

Classic SQL syntax:

UPDATE categories SET name='Software' WHERE _key = '0'

Delete One Document in the Collection​

Delete one document in the collection with a query.

Classic SQL syntax:

DELETE FROM categories WHERE _key='0'

Get One Document from the Collection​

Get one document from the collection with a query.

Classic SQL syntax:

SELECT * FROM categories WHERE _key='0'

Get all Documents from the Collection​

Get all documents from the collection with a query.

Classic SQL syntax:

SELECT * FROM categories

Send SQL Queries with Macrometa SDKs​

  • First we need to add dependency for Macrometa SDK.
  • To create instance of jsc8 we need to provide URL and fabric name to jsc8 constructor. jsc8 holds all the methods needed to work with Macrometa platform.
  • Function await client.login(email, password) will do a login to Macrometa platform.
  • Function await client.executeQuery(query, {}, { sql: true }) with sql as a field in object sends SQL query to Macrometa platform.
const jsc8 = require("jsc8");

// Authentication parameters
const email = "nemo@nautilus.com";
const password = "xxxxxx";
const fabric = "_system";

// SQL Query
const query = "SELECT * FROM categories";

const client = new jsc8({
  url: "https://play.paas.macrometa.io",
  fabricName: fabric
});

async function sqlQueries() {
    await client.login(email, password);
    const result = await client.executeQuery(
         query, {}, { sql: true }
    );
    // Test data will be printed in the terminal
    await console.log(result);
  }
  
sqlQueries();