" 아니요, 눈이 속지 않고 제대로 읽으셨습니다. 많은 분들의 요청에 따라 Couchbase Ruby SDK가 다시 출시되어 매우 기쁘게 생각합니다! "
유용한 링크
소개
Couchbase Ruby SDK를 사용하면 네이티브 Ruby의 확장인 간소화된 고성능 API를 사용해 Ruby에서 Couchbase 클러스터에 연결할 수 있습니다. 저희 SDK는 서버 기능의 미래를 염두에 두고 작성되어 새로운 데이터 관리 방식이 될 범위 및 컬렉션과 같은 기능을 지원합니다.
호환성
카우치베이스 루비 SDK 3.0은 다음과 같습니다.
-
- 2.5.0 이상의 모든 MRI Ruby 버전과 호환됩니다.
- 6.0.0 이상의 Couchbase 서버 버전에서 완벽하게 지원됩니다.
호환성에 대한 자세한 내용은 다음을 참조하세요. 여기.
설치
공식 문서에 언급된 단계에 따라 루비를 설치할 수 있습니다. 루비 웹사이트.
Ruby가 설치되면 Couchbase용 Ruby SDK 베타 버전을 설치하는 것은 매우 간단합니다. 터미널 창에서 다음 명령을 입력하기만 하면 됩니다,
|
1 |
gem 설치 --pre 카우치베이스 |
참고 : - pre 는 필요 에 지시 보석 에 베타 설치 버전 의.
또한 미리 컴파일된 확장 기능이 포함된 겜 리포지토리도 제공합니다. C/C++ 컴파일러를 설치할 수 없는 경우 이를 사용하여 젬을 설치하는 동안 확장 프로그램을 빌드하세요. 자세한 지침은 이 페이지를 참조하세요: 카우치베이스 루비 릴리즈 노트 및 아카이브
Couchbase 클러스터에 연결
카우치베이스 서버 클러스터에 대한 연결은 다음과 같이 표시됩니다. 클러스터 객체입니다. A 클러스터 는 버킷, 범위 및 컬렉션은 물론 다양한 Couchbase 서비스 및 관리 인터페이스에 대한 액세스를 제공합니다.
Couchbase Cluster에 연결하는 방법은 매우 간단합니다. 카우치베이스 라이브러리 가져오기 그리고 연결 메서드를 호출합니다. 를 사용하여 자격 증명을 전달하여 클러스터 객체의 클러스터 옵션 아래에서 볼 수 있듯이.
|
1 2 3 4 5 6 |
require "couchbase" # 카우치베이스 라이브러리 가져오기 포함 카우치베이스 옵션 = 클러스터::클러스터 옵션.new 옵션.인증("관리자", "비밀번호") 클러스터 = 클러스터.연결("couchbase://localhost", 옵션) |
특징
이 새로운 보석은 간단하고 장황하지 않은 많은 새롭고 향상된 기능을 제공합니다.
아래에서 개발자 미리 보기 모드에서 Couchbase Server 버전 6.5.1을 사용하는 예제와 함께 일부 기능의 주요 내용을 확인할 수 있습니다. 여행 샘플 그리고 맥주 샘플 버킷이 추가되었습니다.
포괄적인 기능에 대한 자세한 내용은 문서.
키 값 연산
데이터 서비스라고도 하는 키 값 작업은 문서 키를 알고 있는 데이터를 검색하거나 변경하는 가장 간단하고 빠른 방법을 제공합니다.
이 예에서는 여행 샘플 기본 컬렉션을 사용합니다,
-
-
-
-
- 키를 사용하여 새 문서를 만듭니다(문서가 이미 있는 경우 업데이트). "foo" .
- 문서를 검색합니다.
- 문서를 제거/삭제합니다.
-
-
-
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
require 'couchbase' 포함 카우치베이스 옵션 = 클러스터::클러스터 옵션.new 옵션.인증("관리자", "비밀번호") 클러스터 = 클러스터.연결("couchbase://localhost", 옵션) 버킷 = 클러스터.버킷("travel-sample") 컬렉션 = 버킷.기본값_컬렉션 res = 컬렉션.업서트("foo", {"bar" => 42}) res = 컬렉션.get("foo") 풋 res.콘텐츠 res = 컬렉션.제거("foo") 풋 res 클러스터.연결 끊기 |
하위 문서 작업
하위 문서 작업에 효율적으로 액세스하는 데 사용할 수 있습니다. 부품 하위 문서 경로를 사용하는 문서보다 더 빠르고 네트워크 효율이 높을 수 있습니다. 전체 문서 다음과 같은 작업 업서트, 대체 그리고 get 네트워크를 통해 문서의 액세스된 부분만 전송하기 때문입니다. 또한 이러한 작업은 원자적이기 때문에 동시성 제어 기능이 내장된 문서를 안전하게 수정할 수 있습니다.
아래 예는 하위 문서 경로인 팩스, 이메일을 사용하여 키로 문서를 변경하는 예제입니다. "customer123".
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 |
require 'couchbase' 포함 카우치베이스 옵션 = 클러스터::클러스터 옵션.new 옵션.인증("관리자", "비밀번호") 클러스터 = 클러스터.연결("couchbase://localhost", 옵션) 버킷 = 클러스터.버킷("default") 컬렉션 = 버킷.기본값_컬렉션 문서 = { 이름: "더글러스 레이놀름", 이메일: "douglas@reynholmindustries.com" } 컬렉션.업서트("customer123", 문서) res = 컬렉션.mutate_in("customer123", [ MutateInSpec.업서트("팩스", "311-555-0151"), MutateInSpec.대체("이메일", "dougr96@hotmail.com"), ]) |
쿼리
SQL을 기반으로 하지만 구조화되고 유연한 JSON 문서용으로 설계된 언어인 N1QL 쿼리 언어를 사용하여 Couchbase에서 문서를 쿼리할 수 있습니다. 쿼리를 통해 이메일 주소, Facebook 로그인 또는 사용자 ID로 사용자 프로필을 찾는 것과 같은 일반적인 프로그래밍 작업을 해결할 수 있습니다.
아래 예에서는 명명된 매개 변수를 사용하여 다음과 같은 유형의 문서 10개를 검색합니다. "호텔" 에서 여행 샘플 버킷.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
require 'couchbase' 포함 카우치베이스 옵션 = 클러스터::클러스터 옵션.new 옵션.인증("관리자", "비밀번호") 클러스터 = 클러스터.연결("couchbase://localhost", 옵션) 옵션 = 클러스터::쿼리 옵션.new 옵션.named_parameters({유형: "호텔"}) res = 클러스터.쿼리("SELECT * FROM `travel-sample` WHERE type = $type LIMIT 10", 옵션) res.행.각 do |행| 풋 "#{row["여행-샘플"]["국가"]}. #{row["여행-샘플"]["이름"]}" 끝 |
분석
카우치베이스의 분석 서비스는 복잡한 임시 쿼리를 실행하여 운영 워크로드에 영향을 주지 않고 운영 데이터에 대한 인사이트를 수집할 수 있는 기능을 제공합니다. 쿼리 구문은 기본적으로 N1QL과 동일하므로 SQL 지식을 활용하여 JSON 데이터에 대한 분석 쿼리를 실행할 수 있습니다.
아래 예는 위치 매개 변수를 사용하여 다음을 검색합니다. 공항 수 프랑스에서 공항 데이터 세트 에 생성되었습니다. 여행 샘플 버킷.
|
1 2 3 4 5 6 7 8 9 10 11 12 |
require 'couchbase' 포함 카우치베이스 옵션 = 클러스터::클러스터 옵션.new 옵션.인증("관리자", "비밀번호") 클러스터 = 클러스터.연결("couchbase://localhost", 옵션) 옵션 = 클러스터::애널리틱스 옵션.new 옵션.위치_파라미터(["프랑스"]) 결과 = 클러스터.분석_쿼리('SELECT COUNT(*) AS airport_count FROM airports WHERE country = ?',옵션) 풋 "프랑스 공항: #{res.rows.first["공항_카운트"]}" |
결론
이 새로운 보석을 사용하여 다음 애플리케이션을 구축할 준비가 되셨기를 바랍니다!
질문이나 피드백이 있으시면 언제든지 문의하세요, 개발자 커뮤니티에 들러보세요. 여러분의 의견을 듣고 싶습니다. 다음 링크에서 SDK를 확인할 수도 있습니다. GitHub.
행복한 프로그램 !!!
루비 SDK와 카우치베이스의 쉬운 단계별 접근 방식과 명료함이 마음에 듭니다!