빠른 팁: SingleStoreDB의 데이터 API 사용

추상적인

SingleStoreDB는 HTTP 연결을 통해 SQL 문을 실행하는 데 사용할 수 있는 Data API을 제공합니다. 이 짧은 문서에서는 이 데이터 API를 사용하는 방법에 대한 예를 보여줍니다.

SingleStoreDB 클라우드 계정 생성

A는 무료 SingleStoreDB Cloud 계정을 만드는 데 필요한 단계를 보여주었습니다. Iris Demo Group을 작업 공간 그룹 이름으로 사용하고 iris-demo를 작업 공간 이름으로 사용합니다. 암호와 호스트 이름을 기록해 둡니다.

데이터 API 테스트

데이터 API는 기본적으로 활성화되어 있으며 다음과 같이 명령줄에서 매우 빠르게 테스트할 수 있습니다.

curl https://<host>/ping

<host>를 SingleStoreDB Cloud 계정의 값으로 대체합니다.

결과는 다음과 같아야 합니다.

pong

데이터베이스 만들기

이제 데이터베이스를 생성해 보겠습니다.

curl -u "admin:<password>" \ 
     -H "Content-Type: application/json" \
     --data '{"sql" : "CREATE DATABASE iris_demo"}' \ 
     https://<host>/api/v2/exec

<password> 및 <host>를 SingleStoreDB Cloud 계정의 값으로 바꿉니다.

결과는 다음과 같아야 합니다.

{"lastInsertId":0,"rowsAffected":1}

테이블 만들기

이제 테이블을 생성해 보겠습니다.

curl -u "admin:<password>" \
     -H "Content-Type: application/json" \
     --data '{"sql" : "CREATE TABLE iris (sepal_length FLOAT, sepal_width FLOAT, petal_length FLOAT, petal_width FLOAT, species VARCHAR(20))", "database" : "iris_demo"}' \
     https://<host>/api/v2/exec

결과는 다음과 같아야 합니다.

{"lastInsertId":0,"rowsAffected":0}

테이블에 데이터 로드

이제 MySQL 클라이언트를 사용하여 일부 데이터를 데이터베이스에 로드합니다.

먼저 CSV이 포함된 Iris flower data set 파일을 다운로드합니다.

다음으로 클라이언트를 시작합니다.

mysql --local-infile \
      -u admin \
      -h <host> \
      -P 3306 \
      --default-auth=mysql_native_password \
      -p

<host>는 SingleStoreDB Cloud에서 얻은 값으로 대체됩니다.

마지막으로 다음과 같이 CSV 파일 데이터를 데이터베이스 테이블에 로드합니다.

USE iris_demo;

LOAD DATA LOCAL INFILE '/path/to/iris.csv'
INTO TABLE iris
IGNORE 1 LINES
COLUMNS TERMINATED BY ',';

/path/to/를 CSV 파일이 있는 실제 경로로 바꿉니다.

쿼리 수행

그런 다음 다음과 같은 쿼리를 수행할 수 있습니다.

curl -u "admin:<password>" \
     -H "Content-Type: application/json" \
     --data '{"sql" : "SELECT * FROM iris LIMIT 5", "database" : "iris_demo"}' \
     https://<host>/api/v2/query/rows

결과는 다음과 유사해야 합니다.

{
   "results":[
      {
         "rows":[
            {
               "sepal_length":5.7,
               "sepal_width":4.4,
               "petal_length":1.5,
               "petal_width":0.4,
               "species":"Iris-setosa\r"
            },
            {
               "sepal_length":4.4,
               "sepal_width":3,
               "petal_length":1.3,
               "petal_width":0.2,
               "species":"Iris-setosa\r"
            },
            {
               "sepal_length":5,
               "sepal_width":3.5,
               "petal_length":1.6,
               "petal_width":0.6,
               "species":"Iris-setosa\r"
            },
            {
               "sepal_length":6.7,
               "sepal_width":3.1,
               "petal_length":4.7,
               "petal_width":1.5,
               "species":"Iris-versicolor\r"
            },
            {
               "sepal_length":5.7,
               "sepal_width":3,
               "petal_length":4.2,
               "petal_width":1.2,
               "species":"Iris-versicolor\r"
            }
         ]
      }
   ]
}

요약

SingleStoreDB 데이터 API는 우리가 SingleStoreDB로 작업할 수 있는 또 다른 방법을 제공합니다. 이 방법은 특정 유형의 애플리케이션 및 통합에 유용할 수 있습니다. 이것은 SingleStoreDB가 제공하는 유연성의 또 다른 예입니다.