NoSQL 서버인 Couchbase의 Client SDK를 이용하여 .NET 어플리케이션을 개발하기 위한 기초지식 습득을 위한 프리젠테이션

1. Couchbase를 사용한
응용프로그램 개발 방법 개요

2. 목표
Client SDK
기본 조작 method
그 외 method
질의 응답

3. Couchbase를 DB로 사용하여
클라이언트 응용프로그램을
개발하기 위한 환경에 대한 이해
기본적인 조작방법 숙지

4. 카우치베이스 사이트
http://www.couchbase.com/communities/all-
client-libraries
http://www.couchbase.com/documentation
http://www.couchbase.com/presentations

5. Client SDK의 종류와 특징, 설치 및 사용방법

6.  아래 URL에서 개발하고자 하는 언어의 SDK를 다운로드
 http://www.couchbase.com/communities/all-client-libraries

8.  .NET 3.5와 4.0용 어셈블리 제공
의존하는 어셈블리에 의해 Client Profile은 비권장 됨
 Visual Studio의 Nuget 플러그인 사용시
아래 명령으로 설치 가능
 Install-Package CouchbaseNetClient
 Github에서 소스코드 다운로드 가능
 git clone https://github.com/couchbase/couchbase-
net-client.git
 출처 : http://docs.couchbase.com/couchbase-sdknet-1.3/

9. 어셈블리 파일 내용
카우치베이스 라이브러리 본체
Couchbase.dll
Memcached 라이브러리
Enyim.Caching.dll
로그 어댑터
 Enyim.Caching.Log4NetAdapter.dll
 Enyim.Caching.NLogAdapter.dll
기타 utility 라이브러리
Newtonsoft.Json.dll : JSON문자열 파싱/생성
NLog.dll, log4net.dll : 로그 생성 및 기록

10. DB연결
조회/조작(CRUD)
카운터

11. app|web.config를 사용한 DB연결 설정
<?xml version="1.0"?>
<configuration>
<configSections>
<section name="couchbase"
type="Couchbase.Configuration.CouchbaseClientSection, Couch
base"/>
</configSections>
<couchbase>
<servers bucket="default" bucketPassword="">
<add uri="http://192.168.0.2:8091/pools"/>
<add uri="http://192.168.0.3:8091/pools"/>
</servers>
</couchbase>
</configuration>

12. 싱글톤 패턴으로 Client객체 생성
public static class CouchbaseManager
{
private readonly static CouchbaseClient _instance;
static CouchbaseManager()
{
_instance = new CouchbaseClient();
}
public static CouchbaseClient Instance {
get { return _instance; }
}
}

13. DB연결 코드 작성 예 1 : Bucket목록 조회
//app.config의 url을 추출
var ClusterNodeList = (
(CouchbaseClientSection)System.Configuration.ConfigurationManag
er.GetSection("couchbase")
).Servers.Urls.ToUriCollection();
//관리자 계정으로 bucket목록 조회
var config = new CouchbaseClientConfiguration()
{
Username = Username,
Password = Password
};
foreach (var uri in ClusterNodeList)
config.Urls.Add(uri);
var buckets = new CouchbaseCluster(config).ListBuckets();

14. DB연결 코드 작성 예 2 : 코드로 연결
config = new CouchbaseClientConfiguration()
{
Bucket = BucketName,
BucketPassword = BucketPassword
};
foreach (var uri in ClusterNodeList)
config.Urls.Add(uri);
ClientInstance = new CouchbaseClient(config);

15. Store Methods
bool
ClientInstance.Store(StoreMode, key, value)
public enum StoreMode {
Add = 1,
Replace = 2,
}
Set = 3,
반환값 : 성공시 true
bool Remove(string key)

16. ExecuteStore Methods
IStoreOperationResult ClientInstance.
ExecuteStore(StoreMode, key, value)
var result = client.ExecuteStore(StoreMode.Add, "beer", new Beer());
if (!result.Success)
{
Console.WriteLine("Store failed with message {0}
and status code {1}",
result.Message, result.StatusCode);
if (result.Exception != null)
throw result.Exception;
}

17. Get Methods
object ClientInstance.Get(key)
T ClientInstance.Get<T>(key)
IDictionary<string, object>
Get(IEnumerable<string> keys)
var dict = client.Get(new string[] { "brewery", "beer" });
Console.WriteLine(dict["brewery"]);
Console.WriteLine(dict["beer"]);

18. Get Methods
CasResult<object> GetWithCas(string key)
public struct CasResult<T>
{
public ulong Cas { get; set; }
public T Result { get; set; }
public int StatusCode { get; set; }
}
bool KeyExists(string key)

19. Counter
ulong Increment(string key, ulong
defaultValue, ulong delta)
ulong Decrement(string key, ulong
defaultValue, ulong delta)
client.Remove("inventory"); //reset the counter
client.Increment("inventory", 100, 1); //counter will be 100
client.Increment("inventory", 100, 1); //counter will be 101

20. 비JSON 문자열 조작
Append/Prepend 메소드
CAS를 이용한 조작
Cas 메소드
ICasOperationResult
Lock을 이용한 조작
GetWithLock/Unlock 메소드

21. View 사용
GetView 메소드
Expiration
Touch 메소드
TimeSpan validFor(초단위)/DateTime expiresAt
Durability
enum PersistTo
enum ReplicateTo

22. • sejini17@n2m.co.kr