SetShardingKey(OracleShardingKey, OracleShardingKey)

このインスタンス・メソッドを使用すると、接続を要求する前に、シャーディング・キーとスーパー・シャーディング・キーをアプリケーションで設定できます。

宣言

// C#
public void SetShardingKey(OracleShardingKey shardKey, OracleShardingKey superShardingKey);

例外

InvalidArgumentException - 無効なOracleシャーディング・キーが指定されています。

InvalidOperationException - このメソッドは、接続がOpen状態のときに呼び出されます。

備考

このメソッドは、Openメッセージを呼び出したとき、適切な接続を返すために使用されるシャーディング・キーおよびスーパー・シャーディング・キーを設定します。

このメソッドは、接続がClosed状態のときにのみ呼び出すことができます。

例

// C#

using System;
using Oracle.DataAccess.Client;
 
class Sharding
{
  static void Main()
  {
    OracleConnection con = new OracleConnection("user id=hr;password=hr;Data Source=orcl;");
    //Setting a shard key
    OracleShardingKey shardingKey = new OracleShardingKey(OracleDbType.Int32, 123);
    //Setting a second shard key value for a composite key
    shardingKey.SetShardingKey(OracleDbType.Varchar2, "gold");
    //Creating and setting the super shard key
    OracleShardingKey superShardingKey = new OracleShardingKey();
    superShardingKey.SetShardingKey(OracleDbType.Int32, 1000);
    
    //Setting super sharding key and sharding key on the connection
    con.SetShardingKey(shardingKey, superShardingKey);
    con.Open();
 
    //perform SQL query
  }
}