![\"ESP32](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/08\/ESP32-Get-Started-Deta-Base.jpg?resize=1200%2C675&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\nTo interact with Deta base using the ESP32, we’ll use the detaBaseArduinoESP32 library<\/a>. The present tutorial was based on the guides created by the library developer. You can find the guides on the following link:<\/p>\n\n\n\n The best way to describe Deta Base<\/a>:<\/p>\n\n\n\n Deta Base is a fully-managed, fast, scalable and secure NoSQL database with a focus on end-user simplicity. It offers a UI<\/a> through which you can easily see, query, update and delete records in the database.<\/p>https:\/\/docs.deta.sh\/docs\/base\/about<\/cite><\/blockquote>\n\n\n\n And the best part is that Deta Base is free <\/strong>to use!<\/p>\n\n\n\n If you’re wondering where your data is saved and if it is secured, here’s the answer:<\/p>\n\n\n\n Your data is encrypted and stored safely on AWS. Encryption keys are managed by AWS; AWS manages Exabytes of the world’s most sensitive data.<\/p>https:\/\/docs.deta.sh\/docs\/base\/about#is-my-data-secure<\/cite><\/blockquote>\n\n\n\n We recommend taking a look at the docs to get more familiar with Deta Base:<\/p>\n\n\n\n Deta Base is still in the beta version, so you may expect improvements in the future.<\/p>\n\n\n\n To get started, you need to create a Deta Base account. Go to deta.sh<\/a>, and click on Join Deta<\/strong> to create a new account.<\/p>\n\n\n\n Enter a username, password, and email to create a new account.<\/p>\n\n\n\n Deta base will send you a verification email. Verify your account, and you should be redirected to your Deta dashboard. The following window pops up:<\/p>\n\n\n\n By default, it creates a new project called “default”. As mentioned, projects are accessed via ids and keys. When you click on the See My Key button<\/strong>, you’ll get your project id and key. Make sure you save it somewhere because you’ll need those later<\/strong>\u2014the key will only be shown once<\/strong>. <\/p>\n\n\n\n When you’re done. Click Close<\/strong>.<\/p>\n\n\n\n The library we’ll use with the ESP32 automatically creates a Base (database table) instance for your project. So, you don’t need to manually create it on the Deta Base interface.<\/p>\n\n\n\n To interact with Deta Base using the ESP32, we’ll use the detaBaseArduinoESP32 library<\/a>. You can install the library in the Arduino IDE. Go to Sketch<\/strong> > Include Library<\/strong> > Manage Libraries<\/strong>. Search for detabasearduinoesp32 <\/strong>and install the library by Kushagra Goel.<\/p>\n\n\n\n In this section, you’ll learn how to program your ESP32 to perform CRUD (create, read, update, delete) operations and queries on Deta Base. The library provides a simple example showing how to do that.<\/p>\n\n\n\n In the Arduino IDE, make sure you have an ESP32 board selected in Tools <\/strong>> Board<\/strong>. Then, go to File <\/strong>> Examples <\/strong>> detabaseAduinoESP32 <\/strong>and select the detaLibTest <\/strong>example.<\/p>\n\n\n\n The following code should load.<\/p>\n\n\n View raw code<\/a><\/p>\n\n\n\n You need to insert your project API KEY and ID. You also need to inserte a name for the database\u2014it can be whatever you want. I called it Test<\/span>.<\/p>\n\n\n\n In the setup()<\/span>, you need to include your network credentials, SSID and password so that your ESP32 can connect to the internet.<\/p>\n\n\n\n You can upload the code now and it will work straight away. We recommend reading through the following section to understand how things actually work.<\/p>\n\n\n\n Read this section to learn how to interact with Deta Base using the ESP32.<\/p>\n\n\n\n First, include the detaBaseArduinoESP32<\/span> library. You also need to include the WiFiClientSecure<\/span> library\u2014this automatically includes the WiFi.h<\/span> library, also needed in this example.<\/p>\n\n\n\n Insert the project key, ID, and a name for the Base. As mentioned previously, if not created yet, the library will automatically create a Base instance for you on Deta Base. The name for the database can be whatever best describes it. In this case, I called it Test<\/span>. If you’ve already created a Base instance manually on Deta Base, you can use it’s name here.<\/p>\n\n\n\n Then, you need to create a WiFiClientSecure<\/span> and a DetaBaseObject<\/span> objects. The DetaBaseObject<\/span> accepts as arguments the WiFi client, the project ID, base name, API key, lastly a boolean variable. This last boolean variable when set to true<\/span> enables debugging statement.<\/p>\n\n\n\n The client<\/span> is passed to the DetaBaseObject<\/span> as is, without any modification. This is done because a root CA certificate is set in the DetaBaseObject<\/span> constructor. This is required since we are making requests over HTTPS.<\/p>\n\n\n\n In the setup()<\/span>, connect the ESP32 to Wi-Fi using your Wi-Fi credentials: SSID and password.<\/p>\n\n\n\n To insert items into the database, you can use the putObject()<\/span> function. As described in the Deta Base documentation<\/a>, a put operation expects a JSON object in the following format:<\/p>\n\n\n\n The key is optional, and will be assigned by Deta Base if not provided. If a key is provided, and an entry already exists with that key, it is overwritten. <\/p>\n\n\n\n The following line of code:<\/p>\n\n\n\n That contains the following JSON:<\/p>\n\n\n\n Adds the following to the database:<\/p>\n\n\n\n A backslash character (\\<\/span>) is added before each “<\/span> to indicate an escape character, since we require “<\/span> in the JSON input. <\/p>\n\n\n\n Note: <\/strong> Keys have to be strings<\/strong>. If you want to use a number as a key, make sure it is interpreted as a string by enclosing it in double-quotes. (Double quotes with back-slashes.)<\/p>\n\n\n\n With PUT you can insert multiple items in a single request. For example:<\/p>\n\n\n\n If the request succeeds, we will see a 200-level status code in the Serial monitor, as well as the entire object(s) with its key(s).<\/p>\n\n\n\n If you go to your Deta Base project, you should see a new base instance and the item we’ve just inserted.<\/p>\n\n\n\n You can retrieve an object by its key using the getObject()<\/span> function. The function expects a key as argument. It can be an existing key or a non-existing key.<\/p>\n\n\n\n The following line of code tries to retrieve an object with cba<\/span> key. <\/p>\n\n\n\n You should get an error message because there isn’t any object with that key on the database yet.<\/p>\n\n\n\n However, if you manually create an object with the cba<\/span> key and run the code again, it will retrieve the object with success.<\/p>\n\n\n\n To create an object manually, you can click on the +Add <\/strong>button on the deta base interface. It will automatically create a new item with a predefined key. You can change it to cba<\/span>.<\/p>\n\n\n\n To delete an object on the database, use the deleteObject()<\/span> function. This function accepts as an argument the key of the object we want to delete. The output of this function returns a 200-level code that indicates success even though there’s no object with that key. In our case, it tries to delete an object with the abc<\/span> key. <\/p>\n\n\n\n However, if there was an object with the abc<\/span> key it would be deleted.<\/p>\n\n\n\n To insert a new item in the database, you can use the insertObject()<\/span> function that will make a POST request<\/a>. This will create a new item only if no item with the same key exists. It expects a JSON in the following format:<\/p>\n\n\n\n If you don’t provide a key, Deta Base will automatically do that for you.<\/p>\n\n\n\n In the example, the following line:<\/p>\n\n\n\n Adds the following object to the database:<\/p>\n\n\n\n If you’re already have an object with that key you’ll get a 400-level code and an error in the payload message.<\/p>\n\n\n\n The updateObject()<\/span> method updates existing entries. It accepts as arguments the key for an existing objkect and a JSON object in the following format:<\/p>\n\n\n\n All of those JSON sub-objects (set<\/span>, increment<\/span>, append<\/span>, prepend<\/span>, and delete<\/span>) are optional.<\/p>\n\n\n\n You can learn more about this type of request on the documentation<\/a>.<\/p>\n\n\n\n In our example, the following line will increment the age by 1 in the entry with the abc<\/span> key.<\/p>\n\n\n\n Deta Base also supports queries for fetching data that match certain conditions. You can learn more about Deta Base Queries on the following link:<\/p>\n\n\n\n To make a query you can use the query()<\/span> function that accepts as argument the query itself in JSON format (see the link to the documentation above).<\/p>\n\n\n\n The following query will return all the objects whose value of age is less than 10, which in our case corresponds to all objects in the database.<\/p>\n\n\n\n After running the example, you should get the following on the Serial Monitor.<\/p>\n\n\n\n And your database should look as follows.<\/p>\n\n\n\n In this tutorial, you learned how to interact with Deta Base using the ESP32. Deta Base is a NoSQL database, it’s free and unlimited. This means you won’t have to pay anything to use it, and you can add as many entries as needed. The database requires minimal setup and you can use it right away. Thanks to the detaBaseArduinoESP32 library<\/a>, it’s even easier to make HTTP requests to the database and handle the responses.<\/p>\n\n\n\n In this example, you learned how to insert sample values. You can easily modify the examples to save sensor readings, for example, or GPIO states. <\/p>\n\n\n\n The present tutorial was based on the tutorial created by Kushagra Goel<\/a>.<\/p>\n\n\n\n We hope you found this article useful.<\/p>\n\n\n\n We have guides for other popular databases with the ESP32:<\/p>\n\n\n\n Learn more about the ESP32 with our resources:<\/p>\n\n\n\n Thanks for reading.<\/p>\n","protected":false},"excerpt":{"rendered":" Get started with Deta Base using the ESP32 board. Deta Base is a NoSQL database. It is unlimited, free, and easy to use. Additionally, it requires minimal setup. So, it’s … <\/p>\nIntroducing Deta Base<\/h2>\n\n\n\n
Creating a Deta Base Account<\/h2>\n\n\n\n
![\"deta](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/08\/deta-base-website.jpg?resize=750%2C364&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\n![\"deta](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/08\/Deta-base-sign-up.jpg?resize=456%2C498&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\n![\"Creating](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/08\/see-my-key-deta-base.png?resize=593%2C283&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\n![\"Creating](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/08\/deta-base-project-confidentials.jpg?resize=590%2C347&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\nInstalling the Deta Base Library for ESP32<\/h2>\n\n\n\n
![\"Install](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/08\/install-detabasearduinoesp32-library-Arduino-IDE.png?resize=786%2C443&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\nDeta Base with ESP32: CRUD Operations<\/h2>\n\n\n\n
# Original Source: https:\/\/github.com\/A223D\/detaBaseArduinoESP32\/blob\/main\/examples\/detaLibTest\/detaLibTest.ino\n\n#include <detaBaseArduinoESP32.h>\n#include <WiFiClientSecure.h>\n#define LED 2\n\nchar* apiKey = "MY_KEY";\nchar* detaID = "MY_ID";\nchar* detaBaseName = "MY_BASE";\n\nWiFiClientSecure client;\nDetaBaseObject detaObj(client, detaID, detaBaseName, apiKey, true);\n\n\nvoid setup() {\n Serial.begin(115200);\n Serial.println("Let's begin initialization");\n pinMode(LED, OUTPUT);\n digitalWrite(LED, LOW);\n Serial.println("Reached before WiFi init");\n WiFi.begin("0xCAFE", "0xC0FFEE");\n Serial.println("Waiting to connect to WiFi");\n while (WiFi.status() != WL_CONNECTED) {\n delay(500);\n Serial.print(".");\n }\n Serial.println();\n digitalWrite(LED, HIGH);\n\n}\n\n\/\/ PUT "{\\"items\\":[{\\"age\\":4}]}"\n\n\/\/INSERT "{\\"item\\":{\\"key\\":\\"cba\\",\\"age\\":4}}"\n\n\/\/INSERT "{\\"item\\":{\\"key\\":\\"abc\\",\\"age\\":4}}"\n\n\/\/UPDATE "{\\"increment\\":{\\"age\\":1}}", key:abc\n\n\/\/UPDATE "{\\"increment\\":{\\"age\\":1}}", key:cba\n\n\/\/QUERY "{\\"query\\":[{\\"age?lt\\": 10}]}"\n\nvoid loop() {\n printResult(detaObj.putObject("{\\"items\\":[{\\"age\\":4}]}"));\n Serial.println();\n printResult(detaObj.getObject("cba"));\n Serial.println();\n printResult(detaObj.deleteObject("abc"));\n Serial.println();\n printResult(detaObj.insertObject("{\\"item\\":{\\"key\\":\\"cba\\",\\"age\\":4}}"));\n Serial.println();\n printResult(detaObj.insertObject("{\\"item\\":{\\"key\\":\\"abc\\",\\"age\\":4}}"));\n Serial.println();\n printResult(detaObj.updateObject("{\\"increment\\":{\\"age\\":1}}", "abc"));\n Serial.println();\n printResult(detaObj.updateObject("{\\"increment\\":{\\"age\\":1}}", "bcs"));\n Serial.println();\n printResult(detaObj.query("{\\"query\\":[{\\"age?lt\\": 10}]}"));\n Serial.println();\n\n while (true);\n}\n<\/code><\/pre>\n\tchar* apiKey = \"REPLACE_WITH_YOUR_PROJECT_API_KEY\";\nchar* detaID = \"REPLACE_WITH_YOUR_PROJECT_ID\";\nchar* detaBaseName = \"Test\";<\/code><\/pre>\n\n\n\nWiFi.begin(WIFI_SSID, WIFI_PASSWORD);<\/code><\/pre>\n\n\n\nHow it Works<\/h2>\n\n\n\n
Include Libraries<\/h3>\n\n\n\n
#include <detaBaseArduinoESP32.h>\n#include <WiFiClientSecure.h><\/code><\/pre>\n\n\n\nDeta Base Key, ID, and Name<\/h3>\n\n\n\n
char* apiKey = \"REPLACE_WITH_YOUR_PROJECT_API_KEY\";\nchar* detaID = \"REPLACE_WITH_YOUR_PROJECT_ID\";\nchar* detaBaseName = \"Test\";<\/code><\/pre>\n\n\n\nCreating a DetaBaseObject<\/h3>\n\n\n\n
WiFiClientSecure client;\n\/\/choose this:\nDetaBaseObject detaObj(client, detaID, detaBaseName, apiKey, true);\n\/\/or this:\n\/\/DetaBaseObject detaObj(client, detaID, detaBaseName, apiKey);<\/code><\/pre>\n\n\n\nsetup()<\/h3>\n\n\n\n
void setup() {\n Serial.begin(115200);\n Serial.println(\"Let's begin initialization\");\n pinMode(LED, OUTPUT);\n digitalWrite(LED, LOW);\n Serial.println(\"Reached before WiFi init\");\n WiFi.begin(WIFI_SSID, WIFI_PASSWORD);\n<\/strong> Serial.println(\"Waiting to connect to WiFi\");\n while (WiFi.status() != WL_CONNECTED) {\n delay(500);\n Serial.print(\".\");\n }\n Serial.println();\n digitalWrite(LED, HIGH);\n}<\/code><\/pre>\n\n\n\nInsert<\/h3>\n\n\n\n
{\n \/\/ array of items to put\n \"items\": [\n {\n \"key\": {key}, \/\/ optional, a random key is generated if not provided\n \"field1\": \"value1\",\n \/\/ rest of item\n },\n \/\/ rest of items\n ]\n}<\/code><\/pre>\n\n\n\nprintResult(detaObj.putObject(\"{\\\"items\\\":[{\\\"age\\\":4}]}\"));<\/code><\/pre>\n\n\n\n{\n \"items\":[\n {\n \"age\":\"4\"\n }\n ]\n}<\/code><\/pre>\n\n\n\n{\n \"age\": 4\n}<\/code><\/pre>\n\n\n\nprintResult(detaObj.putObject(\"{\\\"items\\\":[{\\\"age\\\":4,\\\"weight\\\":28}]}\"));<\/code><\/pre>\n\n\n\nRetrieve an Object<\/h3>\n\n\n\n
printResult(detaObj.getObject(\"cba\"));<\/code><\/pre>\n\n\n\nDelete<\/h3>\n\n\n\n
printResult(detaObj.deleteObject(\"abc\"));<\/code><\/pre>\n\n\n\nInsert<\/h3>\n\n\n\n
{\n \"item\": {\n \"key\": {key}, \/\/ optional\n \/\/ rest of item\n }\n}<\/code><\/pre>\n\n\n\nprintResult(detaObj.insertObject(\"{\\\"item\\\":{\\\"key\\\":\\\"cba\\\",\\\"age\\\":4}}\"));<\/code><\/pre>\n\n\n\n{\n \"key\": \"cba\",\n \"age\": 4\n}<\/code><\/pre>\n\n\n\nUpdate<\/h3>\n\n\n\n
{\n \"set\" : {\n \/\/set some attribute to some value like\n \/\/age: 10\n },\n \"increment\" :{\n \/\/increment some attribute by some value like\n \/\/age: 1\n },\n \"append\": {\n \/\/append some value to some list attribute like\n \/\/names: [\"John\"]\n },\n \"prepend\": {\n \/\/append some value to some list attribute like\n \/\/names: [\"Sam\"]\n },\n \"delete\": [\/\/attributes to be deleted]\n}<\/code><\/pre>\n\n\n\n printResult(detaObj.updateObject(\"{\\\"increment\\\":{\\\"age\\\":1}}\", \"abc\"));<\/code><\/pre>\n\n\n\nQuery Data<\/h3>\n\n\n\n
printResult(detaObj.query(\"{\\\"query\\\":[{\\\"age?lt\\\": 10}]}\"));<\/code><\/pre>\n\n\n\nDemonstration<\/h2>\n\n\n\n
![\"ESP32](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/08\/ESP32-with-deta-base-demonstration-serial-monitor-1.png?resize=601%2C774&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\n![\"ESP32](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/08\/ESP32-with-deta-base-demonstration-serial-monitor-2.png?resize=601%2C774&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\n![\"deta](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/08\/deta-base-demonstration.png?resize=750%2C398&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\nWrapping Up<\/h2>\n\n\n\n