# DB Cache 安裝和網絡設置

## DB cache 的遊戲資料庫架構

DB cache的數據庫方案可以按照用戶的意願配置。

但是，要遵守以下規則。

> * 您必須進入 RootUUID、 OwnerUID 和 UUID 字段 。
> * 將RootUUID、OwnerUID、UUID指定爲<mark style="color:orange;">Combination PK</mark>後使用，會對使用索引的搜索產生不利影響。 因此，創建和使用各自的index有助於提高性能。
> * 在上述字段中的RootUUID和OwnerUID被指定爲<mark style="color:orange;">Non-Unique Index</mark>。 UUID 被指定爲 Primary Key 。
> * 上述字段應爲MySQL至varchar(38)格式,MSSQL爲<mark style="color:orange;">uniqueidentifier</mark>格式。
> * Root table和Child table的名稱不應重複。
> * DB cache客戶端和服務器使用的<mark style="color:orange;">stored procedure</mark>會自動添加到遊戲數據庫方案，請不要修改或刪除這些方案。

<figure><img src="https://content.gitbook.com/content/hhO5qj4oN2uLfVC5EG5W/blobs/zInsJ92DNmg0cjhXKu86/db_schema_ex.png" alt=""><figcaption><p>MMORPG中保存玩家數據的數據庫方案的示例</p></figcaption></figure>

**3 個必需索引添加示例腳本**

```sql
ALTER TABLE dbo.Gamer ADD CONSTRAINT
 
PK_Gamer PRIMARY KEY CLUSTERED
 
(
 
UUID
 
) WITH( IGNORE_DUP_KEY = OFF) ON [PRIMARY]
 
 
 
CREATE INDEX IX_Gamer_OwnerUUID ON dbo.Gamer
 
(
 
OwnerUUID
 
) WITH( IGNORE_DUP_KEY = OFF) ON [PRIMARY]
 
 
 
CREATE INDEX IX_Gamer_RootUUID ON dbo.Gamer
 
(
 
RootUUID
 
) WITH( IGNORE_DUP_KEY = OFF) ON [PRIMARY]
```

## DB cache 服務器準備

生成數據庫方案後，需要生成DB cache server實例，是<mark style="color:orange;">Proud.CDbCacheServer2</mark>類型，實例在每個遊戲服務器之間只需1個。

<table><thead><tr><th width="305">實例</th><th>註釋</th></tr></thead><tbody><tr><td>Proud.CDbCacheServer2.New</td><td>創建實例</td></tr><tr><td>Proud.CDbCacheServer2.Start</td><td>執行</td></tr></tbody></table>

> * 連接DB實例的連接連接是ADO連接連接連接形式，樣品中可參考。
> * DB cache server 的認證 key 是 DB cache client 發送的數據，用於識別 DB cache 服務器上的連接。
> * 調用 <mark style="color:orange;">Proud.CDbCacheServer2.Start</mark> 時， 您必須在 <mark style="color:orange;">Proud.CDbCacheServer2StartParameter.m\_tableNames</mark> 中插入用戶定義的表名 。
> * 在 <mark style="color:orange;">Proud.CDbCacheServer2.Start</mark> 運行期間，將自動生成 <mark style="color:orange;">sp\_Get<表格名稱>Data</mark> 和 <mark style="color:orange;">sp\_Remove<表格名稱>Data</mark> 以及 <mark style="color:orange;">sp\_Add<表格名稱>Data</mark>。

## DB Cache 客戶端準備

每個遊戲服務器（認證服務器、遊戲zone服務器、遊說服務器等）都必須運行<mark style="color:orange;">Proud.CDbCacheClient2.New</mark>以創建client實例，類型爲<mark style="color:orange;">Proud.CDbCacheClient2</mark>。

創建後， 您必須嘗試通過 <mark style="color:orange;">Proud.CDbCacheClient2.Connect</mark> 連接到 DB cache server 。 嘗試連接以異步方式進行，如果連接成功或失敗，則 <mark style="color:orange;">Proud.IDbCacheClientDelegate2.OnJoinDbCacheServerComplete</mark> 將返回。\
DB cache client 是用於內部使用 <mark style="color:orange;">Proud.CLanClient</mark> 的線程合併， 因此沒有單獨的 FrameMove 。<br>

爲了解除與DB cache server 的連接， 可能會破壞 <mark style="color:orange;">Proud.CDbCacheClient2</mark> 對象或調用 <mark style="color:orange;">Proud.CDbCacheClient2.Disconnect</mark> 。 此時，DB cache客戶端的<mark style="color:orange;">Proud.IDbCacheClientDelegate2.OnLeaveDbCacheServer</mark>將被回撥。

<br>