

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Amazon Keyspaces 테이블에 데이터 삽입 및 로드
<a name="getting-started.dml.create"></a>

`book_awards` 테이블에 데이터를 만들려면 `INSERT` 문을 사용하여 행 하나를 추가합니다.

1. 를 AWS CloudShell 열고 다음 명령을 사용하여 Amazon Keyspaces에 연결합니다. *us-east-1*을 자체 리전으로 업데이트해야 합니다.

   ```
   cqlsh-expansion cassandra.us-east-1.amazonaws.com 9142 --ssl
   ```

   해당 명령의 결과는 다음과 같아야 합니다.

   ```
   Connected to Amazon Keyspaces at cassandra.us-east-1.amazonaws.com:9142
   [cqlsh 6.1.0 | Cassandra 3.11.2 | CQL spec 3.4.4 | Native protocol v4]
   Use HELP for help.
   cqlsh current consistency level is ONE.
   ```

1. cqlsh를 사용하여 Amazon Keyspaces 테이블에 데이터를 쓰려면 먼저 현재 cqlsh 세션의 쓰기 일관성을 `LOCAL_QUORUM`으로 설정해야 합니다. 지원되는 일관성 수준에 대한 자세한 내용은 [쓰기 일관성 수준](consistency.md#WriteConsistency) 섹션을 참조하세요. AWS Management Console에서 CQL 편집기를 사용하는 경우에는 이 단계가 필요하지 않음에 유의하십시오.

   ```
   CONSISTENCY LOCAL_QUORUM;
   ```

1. 단일 레코드를 삽입하려면 CQL 편집기에서 다음 명령을 실행합니다.

   ```
   INSERT INTO catalog.book_awards (award, year, category, rank, author, book_title, publisher)
   VALUES ('Wolf', 2023, 'Fiction',3,'Shirley Rodriguez','Mountain', 'AnyPublisher') ;
   ```

1. 다음 명령을 실행하여 데이터가 테이블에 올바르게 추가되었는지 확인합니다.

   ```
   SELECT * FROM catalog.book_awards;
   ```

   문의 출력은 다음과 같아야 합니다.

   ```
    year | award | category | rank | author            | book_title | publisher
   ------+-------+----------+------+-------------------+------------+--------------
    2023 |  Wolf |  Fiction |    3 | Shirley Rodriguez |   Mountain | AnyPublisher
   
   (1 rows)
   ```

**cqlsh를 사용하여 파일에서 여러 레코드를 삽입하려면**

1. 아카이브 파일 [samplemigration.zip](samples/samplemigration.zip)에 포함된 샘플 CSV 파일(`keyspaces_sample_table.csv`)을 다운로드합니다. 아카이브의 압축을 풀고 `keyspaces_sample_table.csv`의 경로를 기록해 둡니다.  
![\[csv 파일을 가져온 후 테이블의 출력을 보여주는 CSV 파일의 스크린샷입니다.\]](http://docs.aws.amazon.com/ko_kr/keyspaces/latest/devguide/images/keyspaces-awards.png)

1.  AWS CloudShell 에서 AWS Management Console 를 열고 다음 명령을 사용하여 Amazon Keyspaces에 연결합니다. *us-east-1*을 자체 리전으로 업데이트해야 합니다.

   ```
   cqlsh-expansion cassandra.us-east-1.amazonaws.com 9142 --ssl
   ```

1. `cqlsh` 프롬프트(`cqlsh>`)에서 키스페이스를 지정합니다.

   ```
   USE catalog ;
   ```

1. 쓰기 일관성을 `LOCAL_QUORUM`으로 설정합니다. 지원되는 일관성 수준에 대한 자세한 내용은 [쓰기 일관성 수준](consistency.md#WriteConsistency) 섹션을 참조하세요.

   ```
   CONSISTENCY LOCAL_QUORUM;
   ```

1. 화면 오른쪽 상단의 **작업을** AWS CloudShell 선택한 다음 **파일 업로드**를 선택하여 이전에 다운로드한 csv 파일을 업로드합니다. 파일의 경로를 적어 둡니다.

1. 키스페이스 프롬프트(`cqlsh:catalog>`)에서 다음 문을 실행합니다.

   ```
   COPY book_awards (award, year, category, rank, author, book_title, publisher) FROM '/home/cloudshell-user/keyspaces_sample_table.csv' WITH header=TRUE ;
   ```

   이 문의 출력은 이것과 비슷해야 합니다.

   ```
   cqlsh:catalog> COPY book_awards (award, year, category, rank, author, book_title, publisher)                      FROM '/home/cloudshell-user/keyspaces_sample_table.csv' WITH delimiter=',' AND header=TRUE ;
   cqlsh current consistency level is LOCAL_QUORUM.
   Reading options from /home/cloudshell-user/.cassandra/cqlshrc:[copy]: {'numprocesses': '16', 'maxattempts': '1000'}
   Reading options from /home/cloudshell-user/.cassandra/cqlshrc:[copy-from]: {'ingestrate': '1500', 'maxparseerrors': '1000', 'maxinserterrors': '-1', 'maxbatchsize': '10', 'minbatchsize': '1', 'chunksize': '30'}
   Reading options from the command line: {'delimiter': ',', 'header': 'TRUE'}
   Using 16 child processes
   
   Starting copy of catalog.book_awards with columns [award, year, category, rank, author, book_title, publisher].
   OSError: handle is closed      0 rows/s; Avg. rate:       0 rows/s
   Processed: 9 rows; Rate:       0 rows/s; Avg. rate:       0 rows/s
   9 rows imported from 1 files in 0 day, 0 hour, 0 minute, and 26.706 seconds (0 skipped).
   ```

1. 다음 쿼리를 실행하여 데이터가 테이블에 올바르게 추가되었는지 확인합니다.

   ```
   SELECT * FROM book_awards ;
   ```

   다음과 같이 출력되어야 합니다.

   ```
    year | award            | category    | rank | author             | book_title            | publisher
   ------+------------------+-------------+------+--------------------+-----------------------+---------------
    2020 |             Wolf | Non-Fiction |    1 |        Wang Xiulan |      History of Ideas | Example Books
    2020 |             Wolf | Non-Fiction |    2 | Ana Carolina Silva |         Science Today | SomePublisher
    2020 |             Wolf | Non-Fiction |    3 |  Shirley Rodriguez | The Future of Sea Ice |  AnyPublisher
    2020 | Kwesi Manu Prize |     Fiction |    1 |         Akua Mansa |     Where did you go? | SomePublisher
    2020 | Kwesi Manu Prize |     Fiction |    2 |        John Stiles |             Yesterday | Example Books
    2020 | Kwesi Manu Prize |     Fiction |    3 |         Nikki Wolf | Moving to the Chateau |  AnyPublisher
    2020 |      Richard Roe |     Fiction |    1 |  Alejandro Rosalez |           Long Summer | SomePublisher
    2020 |      Richard Roe |     Fiction |    2 |        Arnav Desai |               The Key | Example Books
    2020 |      Richard Roe |     Fiction |    3 |      Mateo Jackson |      Inside the Whale |  AnyPublisher
   
   (9 rows)
   ```

`cqlsh COPY`를 사용하여 csv 파일에서 Amazon Keyspaces 테이블로 데이터를 업로드하는 방법에 대한 자세한 내용은 [자습서: cqlsh를 사용하여 Amazon Keyspaces에 데이터 로드](bulk-upload.md) 섹션을 참조하세요.