Snowflakeにデータの書き込みを行うマッピングで最適なパフォーマンスを実現するには、マッピングが処理するデータ量に基づいて、バッチサイズおよびローカルステージングファイルの数にデフォルト値が考慮されるようにします。値を設定する必要がある場合以外は、デフォルト値を使用してマッピングを処理することをお勧めします。

どちらのしきい値に先に到達したかによって、マッピングでのこれらの2つの設定の優先度が決定されます。指定したバッチ行サイズに到達する前にマッピングがローカルステージングファイルの数の基準を満たした場合は、そのしきい値に先に到達するため、ローカルステージングファイルの数が優先されます。

例として、指定したバッチサイズに対するさまざまな設定に発行される挿入コマンドの数と、Snowflakeへの書き込み操作でのローカルステージングファイルの数を示した次の表を参照してください。

シナリオ1: バッチ行サイズが4で、ローカルステージングファイルの数が1である場合。

バッチ行サイズが4で、ローカルステージングファイルが1つである場合は、データの処理時にSnowflakeで2つの挿入ステートメントが実行されます。

行が2つあり、ファイルサイズがデフォルトの50 MBを超えると、次の受信行に新しいファイルが作成されます。ローカルステージングファイルの数が1に設定されている場合、ステージには最大1つのファイルが保持されます。したがって、2つのステージが作成され、それぞれに2行の1つのファイルが保持されます。各ファイルサイズは104038412バイト、つまり1行あたり52019206バイトです。各ステージごとに挿入コマンドが発行され、2つの挿入コマンドが生成されます。

シナリオ2: バッチ行サイズが4で、ローカルステージングファイルの数の値が設定されていない場合。

ローカルステージングファイルの64というデフォルト値を使用して、マッピングでは、ローカルステージングファイルのしきい値に到達しない場合のバッチサイズが考慮されます。

シナリオ3: バッチ行サイズが1で、ローカルステージングファイルの数の値が設定されていない場合。

バッチ行サイズが1で、特定のローカルステージングファイル値が設定されていない場合、ステージングファイルのしきい値に到達しないため、マッピングは4つの行に対して4つの挿入ステートメントを発行します。

シナリオ4: バッチ行サイズが3で、ローカルステージングファイルの数の値が1である場合。

バッチ行サイズ3と1つのローカルステージングファイルを使用して、マッピングは、第1段階で2行、第2段階で1行を処理した後に、2つの挿入コマンドを発行します。

シナリオ5: バッチの行サイズが1で、ローカルステージングファイルの数の値が1である場合。

バッチ行サイズが1でローカルステージングファイルが1つである場合、行サイズが小さく、ステージングファイルのしきい値に到達しないため、行ごとに4つの挿入コマンドが個別に発行されます。