cqlsh 사용하여 Amazon Keyspace에 접속

cqlsh-expansion 설치 및 구성

1. cqlsh-expansion Python 패키지를 설치하려면 pip 명령을 실행할 수 있습니다. 그러면 종속성 목록이 포함된 파일과 함께 pip install을 사용하여 컴퓨터에 cqlsh-expansion 스크립트가 설치됩니다. --user flag가 pip에 플랫폼용 Python 사용자 설치 디렉터리를 사용하도록 지시합니다. Unix 기반 시스템에서는 ~/.local/ 디렉터리여야 합니다.

   cqlsh-expansion을 설치하려면 Python 3가 필요합니다. Python 버전을 확인하려면 Python --version를 사용하세요. 설치하려면 다음 명령을 실행할 수 있습니다.

   python3 -m pip install --user cqlsh-expansion

   결과는 다음과 비슷해야 합니다.

   Collecting cqlsh-expansion
     Downloading cqlsh_expansion-0.9.6-py3-none-any.whl (153 kB)
        ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 153.7/153.7 KB 3.3 MB/s eta 0:00:00
   Collecting cassandra-driver
     Downloading cassandra_driver-3.28.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (19.1 MB)
        ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 19.1/19.1 MB 44.5 MB/s eta 0:00:00
   Requirement already satisfied: six>=1.12.0 in /usr/lib/python3/dist-packages (from cqlsh-expansion) (1.16.0)
   Collecting boto3
     Downloading boto3-1.29.2-py3-none-any.whl (135 kB)
        ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 135.8/135.8 KB 17.2 MB/s eta 0:00:00
   Collecting cassandra-sigv4>=4.0.2
     Downloading cassandra_sigv4-4.0.2-py2.py3-none-any.whl (9.8 kB)
   Collecting botocore<1.33.0,>=1.32.2
     Downloading botocore-1.32.2-py3-none-any.whl (11.4 MB)
        ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 11.4/11.4 MB 60.9 MB/s eta 0:00:00
   Collecting s3transfer<0.8.0,>=0.7.0
     Downloading s3transfer-0.7.0-py3-none-any.whl (79 kB)
        ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 79.8/79.8 KB 13.1 MB/s eta 0:00:00
   Collecting jmespath<2.0.0,>=0.7.1
     Downloading jmespath-1.0.1-py3-none-any.whl (20 kB)
   Collecting geomet<0.3,>=0.1
     Downloading geomet-0.2.1.post1-py3-none-any.whl (18 kB)
   Collecting python-dateutil<3.0.0,>=2.1
     Downloading python_dateutil-2.8.2-py2.py3-none-any.whl (247 kB)
        ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 247.7/247.7 KB 33.1 MB/s eta 0:00:00
   Requirement already satisfied: urllib3<2.1,>=1.25.4 in /usr/lib/python3/dist-packages (from botocore<1.33.0,>=1.32.2->boto3->cqlsh-expansion) (1.26.5)
   Requirement already satisfied: click in /usr/lib/python3/dist-packages (from geomet<0.3,>=0.1->cassandra-driver->cqlsh-expansion) (8.0.3)
   Installing collected packages: python-dateutil, jmespath, geomet, cassandra-driver, botocore, s3transfer, boto3, cassandra-sigv4, cqlsh-expansion
     WARNING: The script geomet is installed in '/home/ubuntu/.local/bin' which is not on PATH.
     Consider adding this directory to PATH or, if you prefer to suppress this warning, use --no-warn-script-location.
     WARNING: The scripts cqlsh, cqlsh-expansion and cqlsh-expansion.init are installed in '/home/ubuntu/.local/bin' which is not on PATH.
     Consider adding this directory to PATH or, if you prefer to suppress this warning, use --no-warn-script-location.
   Successfully installed boto3-1.29.2 botocore-1.32.2 cassandra-driver-3.28.0 cassandra-sigv4-4.0.2 cqlsh-expansion-0.9.6 geomet-0.2.1.post1 jmespath-1.0.1 python-dateutil-2.8.2 s3transfer-0.7.0

   설치 디렉터리가 에 PATH 없는 경우 운영 체제의 지침에 따라 추가해야 합니다. 다음은 우분투 리눅스의 한 예입니다.

   export PATH="$PATH:/home/ubuntu/.local/bin"

   다음 명령을 실행하여 패키지가 설치되었는지 확인할 수 있습니다.

   cqlsh-expansion --version

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

   cqlsh 6.1.0

2. cqlsh-expansion를 구성하려면 설치 후 스크립트를 실행하여 다음 단계를 자동으로 완료할 수 있습니다.

   1. .cassandra 디렉터리가 아직 없으면 사용자 홈 디렉터리에 생성합니다.

   2. 사전 구성된 cqlshrc 구성 파일을 .cassandra 디렉터리에 복사합니다.

   3. Starfield 디지털 인증서를 .cassandra 디렉터리에 복사합니다. Amazon Keyspace는 이 인증서를 사용하여 전송 계층 보안 () TLS 을 통한 보안 연결을 구성합니다. 전송 중 암호화는 Amazon Keyspaces와 주고 받는 데이터를 암호화하여 추가 데이터 보호 계층을 제공합니다.

   스크립트를 먼저 검토하려면 post_install.py의 Github 리포지토리에서 액세스할 수 있습니다.

   다음 명령을 실행하여 스크립트를 사용할 수 있습니다.

   cqlsh-expansion.init

   참고

   pip uninstall를 사용하여 cqlsh-expansion을 제거해도 설치 후 스크립트로 생성된 디렉터리와 파일은 제거되지 않으므로 수동으로 삭제해야 합니다.

cqlsh-expansion을 사용하여 Amazon Keyspace에 접속

1. 다음을 구성하십시오. AWS 리전 그리고 이를 사용자 환경 변수로 추가합니다.

   Unix 기반 시스템에서 기본 지역을 환경 변수로 추가하려면 다음 명령을 실행할 수 있습니다. 이 예제에서는 미국 동부(버지니아 북부)를 사용합니다.

   export AWS_DEFAULT_REGION=us-east-1

   다른 플랫폼을 포함하여 환경 변수를 설정하는 방법에 대한 자세한 내용은 환경 변수 설정 방법을 참조하세요.

2. 서비스 엔드포인트를 찾습니다.

   리전에 적절한 서비스 엔드포인트를 선택합니다. Amazon Keyspaces에 사용할 수 있는 엔드포인트를 검토하려면 Amazon Keyspaces의 서비스 엔드포인트을 참조하세요. 이 예에서는 엔드포인트 cassandra.us-east-1.amazonaws.com을 사용합니다.

3. 인증 방식을 구성합니다.

   보안 강화를 위해 IAM 액세스 키 (IAM사용자, 역할, 페더레이션된 ID) 를 사용하여 연결하는 것이 좋습니다.

   IAM액세스 키를 사용하여 연결하려면 먼저 다음 단계를 완료해야 합니다.

   1. IAM사용자를 만들거나 모범 사례에 따라 사용자가 위임할 수 있는 IAM IAM 역할을 생성하십시오. IAM액세스 키를 만드는 방법에 대한 자세한 내용은 을 참조하십시오생성 및 구성 AWS Amazon Keyspace의 자격 증명.

   2. 역할 (또는 IAM 사용자) 에게 최소한 Amazon Keyspace에 대한 읽기 전용 액세스 권한을 부여하는 IAM 정책을 생성하십시오. IAM사용자 또는 역할이 Amazon Keyspace에 연결하는 데 필요한 권한에 대한 자세한 내용은 을 참조하십시오. Amazon Keyspaces 테이블에 액세스

   3. 다음 예와 같이 IAM 사용자의 액세스 키를 사용자의 환경 변수에 추가합니다.

      export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
      export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

      다른 플랫폼을 포함하여 환경 변수를 설정하는 방법에 대한 자세한 내용은 환경 변수 설정 방법을 참조하세요.

      참고

      Amazon 인스턴스에서 연결하는 경우 EC2 인스턴스에서 Amazon Keyspace로의 트래픽을 허용하는 보안 그룹의 아웃바운드 규칙도 구성해야 합니다. EC2아웃바운드 규칙을 보고 편집하는 방법에 대한 자세한 내용은 Amazon EC2 User Guide의 보안 그룹에 규칙 추가를 참조하십시오.

4. cqlsh-expansion 및 SigV4 인증을 사용하여 Amazon Keyspaces에 접속합니다.

   cqlsh-expansion를 사용하여 Amazon Keyspaces에 접속하려면 다음 명령을 사용합니다. 서비스 엔드포인트를 해당 리전의 올바른 엔드포인트로 바꿔야 합니다.

   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.
   cqlsh>

   연결 오류가 발생하는 경우 문제 해결 정보를 cqlsh를 사용하여 Amazon Keyspaces에 연결할 수 없음 참조하십시오.

   • 서비스별 보안 인증 정보로 Amazon Keyspaces에 접속합니다.

     Cassandra가 인증에 사용하는 기존 사용자 이름 및 암호 조합으로 접속하려면 먼저 Amazon Keyspace에 프로그래밍 방식으로 액세스하기 위한 서비스별 자격 증명 생성에 설명된 대로 Amazon Keyspaces에 대한 서비스별 보안 인증 정보를 생성해야 합니다. 또한 해당 사용자에게 Amazon Keyspace에 액세스할 수 있는 권한을 부여해야 합니다. 자세한 내용은 Amazon Keyspaces 테이블에 액세스 섹션을 참조하세요.

     사용자에 대한 서비스별 보안 인증 정보와 권한을 생성한 후에는 일반적으로 사용자 디렉터리 경로 ~/.cassandra/에 있는 cqlshrc 파일을 업데이트해야 합니다. cqlshrc 파일에서 Cassandra [authentication] 섹션으로 이동하여 다음 예제와 같이 “;” 문자를 사용하여 [auth_provider]에 있는 SigV4 모듈과 클래스를 주석으로 처리합니다.

     [auth_provider]
     
     ; module = cassandra_sigv4.auth
     
     ; classname = SigV4AuthProvider

     cqlshrc 파일을 업데이트한 후 다음 명령을 사용하여 서비스별 보안 인증 정보로 Amazon Keyspace에 접속할 수 있습니다.

     cqlsh-expansion cassandra.us-east-1.amazonaws.com 9142 -u myUserName -p myPassword --ssl

정리

• pip uninstall 명령을 사용하여 cqlsh-expansion 패키지를 제거할 수 있습니다.

  pip3 uninstall cqlsh-expansion

  pip3 uninstall 명령을 실행해도 설치 후 스크립트로 생성된 디렉터리 및 관련 파일은 제거되지 않습니다. 설치 후 스크립트로 생성된 폴더와 파일을 제거하려면 .cassandra 디렉터리를 삭제하면 됩니다.