ハイブリッドテーブルでサポートされていない機能と制限事項¶

サポートされていない機能と制限に関する次のガイダンスは、ハイブリッドテーブルに適用され、変更される可能性があります。これらのセクションの両方を読むことをお勧めします。

サポートされていない機能¶

ハイブリッドテーブルは次をサポートしません。

Tri-Secret Secure

制限事項¶

クローニング: ハイブリッドテーブルのクローニングはサポートされていませんが、 CREATE <オブジェクト> ... CLONE ステートメントで IGNORE HYBRID TABLES パラメーターを使用することで、ハイブリッドテーブルを含むデータベースとスキーマをクローンすることができます。

クラウドとリージョン

ハイブリッドテーブルは、すべてのAmazon Web Services（AWS）商用リージョンで利用可能です。

以下の制限にご注意ください。

AzureまたはGoogle Cloud Platform（GCP）では、ハイブリッドテーブルは使用できません。
ハイブリッドテーブルは米国SnowGov リージョンでは使用できません。
ハイブリッドテーブルはトライアルアカウントではサポートされていません。
Virtual Private Snowflake（VPS）をご利用の場合は、 Snowflake サポートに連絡して、アカウントのハイブリッドテーブルの有効化についてお問い合わせください。

クラスタリングキー

ハイブリッドテーブルでは、クラスタリングキーはサポートされていません。詳細については、クラスタリングキーとクラスタ化されたテーブルをご参照ください。ハイブリッドテーブルのデータは主キーによって並べられます。

一貫性

デフォルトでは、ハイブリッドテーブルはセッションベースの一貫性モデルを使用し、セッション内の読み取り操作が同じセッション内の書き込み操作からの最新データを返します。セッション外で行われた変更については、一部の停滞（100ミリ秒未満）が発生する可能性があります。停滞を回避するためには、ステートメントレベルまたはセッションレベルで READ_LATEST_WRITES = true を設定します。これにより、数ミリ秒の遅延オーバーヘッドが発生する可能性があることに注意してください。

制約

PRIMARY、 KEY、 UNIQUE、および FOREIGN KEY 制約がハイブリッドテーブルに強制されますが、いくつかの制限が適用されます。詳細については、ハイブリッドテーブルの制約をご参照ください。

COPY

COPY INTO コマンドでハイブリッドテーブルをロードする場合、 ABORT_STATEMENT は ON_ERROR に対してサポートされている唯一のオプションです。 ON_ERROR=SKIP_FILE を設定するとエラーが返されます。詳細については、データのロードをご参照ください。

データサイズ

2つのSnowflakeデータベースにつきハイブリッドテーブルに格納できるデータは1 TB に制限されています。詳細については、クォータとスロットリングをご参照ください。

インデックスでサポートされていないデータ型

地理空間データ型（GEOGRAPHY および GEOMETRY）、半構造化データ型（ARRAY、 OBJECT、 VARIANT）、およびベクトルデータ型（VECTOR）を持つ列は、 PRIMARY KEY 列（自動的にインデックス付けされる）としても、明示的にインデックス付けされた列としてもサポートされません。（ハイブリッドテーブルの列は、列にインデックスが付けられていない限り、これらのデータ型をサポートします。）

TIMESTAMP_TZ データ型（または TIMESTAMP_TZ に解決される TIMESTAMP データ型）は、 UNIQUE、 PRIMARY KEY、 FOREIGN KEY 制約を使用してインデックス付けされている列ではサポートされていません。しかし、 TIMESTAMP_TZ はセカンダリインデックスでサポートされています。

セカンダリインデックスもご参照ください。

DML コマンド

DML コマンドを使用して少数の行を変更する場合は、 MERGE の代わりに INSERT、 UPDATE、 DELETE ステートメントを使用して、パフォーマンスを最適化します。

高次関数

ハイブリッドテーブルに対するクエリでは、 FILTER、 REDUCE、 TRANSFORM 高次関数はサポートされていません。

ネイティブアプリケーション

Snowflake Native Appにハイブリッドテーブルを含めることができます。ただし、プロバイダーからコンシューマーにハイブリッドテーブルを共有することはできません。Native Appは、コンシューマーアカウントにハイブリッドテーブルを作成でき、それらのハイブリッドテーブルに対して読み書きを実行できます。ハイブリッドテーブルをアプリケーションロールに公開して、コンシューマーユーザ－が直接クエリできるようにすることもできます。

プロバイダーアカウントにハイブリッドテーブルを作成することはできません。また、Native Appを通じて共有されるビューにハイブリッドテーブルを含めることもできません。

最適化された一括ロード

ハイブリッドテーブルが空の場合、 CTAS、 COPY、 INSERT INTO ... SELECT はすべて最適化された一括ロードを使用します。ハイブリッドテーブルが空でない場合、最適化された一括ロードは使用されません。詳細については、データのロードをご参照ください。

定期的なキー更新

Snowflakeアカウントで定期的なキー更新の使用が有効になっている場合は、ハイブリッドテーブルは使用できません。アカウントで定期的なキー更新が有効になっており、ハイブリッドテーブルを使用する場合は、 ALTER ACCOUNT コマンドを使用して PERIODIC_DATA_REKEYING パラメーターを FALSE に設定する必要があります。

永続的なクエリ結果

ハイブリッドテーブルに対するクエリは、 USE_CACHED_RESULT パラメーターで定義された結果キャッシュを使用しません。保存済みのクエリ結果の使用をご参照ください。

クォータとスロットリング

共有リソースの公平な可用性を確保し、一貫したサービス品質を保証し、使用量の急増を抑えるために、ハイブリッドテーブルの使用はクォータによって制限されます。

クォータ	デフォルト	メモ
ハイブリッドストレージ	Snowflakeデータベースあたり2 TB	このクォータは、ハイブリッドテーブルに保存できるデータ量を制御します。この制限は、行ストア内のアクティブなハイブリッドテーブルデータにのみ適用され、オブジェクトストレージには適用されません。ストレージクォータを超過した場合、ハイブリッドストレージの使用量をデータ削除によってクォータ以下に戻すまで、ハイブリッドテーブルにデータを追加るす書き込み操作は一時的にブロックされます。
ハイブリッドテーブルリクエスト	Snowflakeデータベースあたり、毎秒約8,000回の操作	このクォータは、ハイブリッドテーブルからの読み取りとハイブリッドテーブルへの書き込みの速度を制御します。80%のポイント読み取りと20%のポイント書き込みで構成されるバランスの取れたワークロードで、ハイブリッドテーブルに対して最高8,000回の操作/秒を達成できるはずです。スロットリングをモニターするには、 AGGREGATE_QUERY_HISTORY ビューの例をご参照ください。
ハイブリッドテーブルを含むデータベース	1つのSnowflakeアカウントにつき合計100件、1時間以内に追加されるデータベースは10件まで	このクォータは、Snowflakeアカウント内でハイブリッドテーブルを含むことができるデータベースの数を制御します。このクォータを超えると、既存のデータベースからすべてのハイブリッドテーブルをドロップしないと、新しいデータベースにハイブリッドテーブルを作成できなくなります。必要に応じて、 Snowflakeサポートにリクエストして、クォータを増やすことができます。

スロットリングは、ハイブリッドテーブルストレージプロバイダーに送信される読み取りと書き込みのリクエストが多すぎるという複合的な要因によって引き起こされる可能性があります。

最適化が不十分なクエリや、クエリの同時実行性が非常に高く、大規模で攻撃的なワークロードが原因で、多くの読み取りリクエストが発生する可能性があります。
書き込みリクエストが多すぎるのは、テーブルのロード時にバルクロードパスが選択されなかったか、ワークロードがあまりにも多くの同時書き込み操作で構成されているためです。

クォータ制限のためにエラーが発生したり、スロットリングが発生した場合は、システム管理者または DBA に連絡して、Unistoreの全体的なワークロードを調べてください。クォータを超えないように変更できる可能性があります。DBAs は、 Snowflakeサポートに問い合わせて、クエリのパフォーマンスとクォータの使用状況を評価することができます。ワークロードによっては、サポートチームにリクエストしてクォータの増加を開始する必要があるかもしれません。

複製

ハイブリッドテーブルの複製は現在サポートされていません。

セカンダリインデックス

以下のセカンダリインデックス機能はサポートされて いません。

インデックスに列を追加します。

既存のハイブリッドテーブルのインデックスを変更します。

ハイブリッドテーブルでセカンダリインデックスを使用するには、テーブルに SELECT 権限を付与されたロールを使用する必要があります。ハイブリッドテーブル自体以外のオブジェクトにしかアクセスできない場合、セカンダリインデックスは使用できません。

TIMESTAMP 列はサポートされています。ただし、ベーステーブルやインデックスの複合キーの一部である TIMESTAMP 列に対する比較（例: WHERE 述語）は、現在サポートされておらず、エラーを引き起こします。

セカンダリインデックスについての詳細は、ハイブリッドテーブルにインデックスを追加するを参照してください。

スループット

アカウント内のハイブリッドテーブルに対して、80%/20%のバランスの取れた読み取り/書き込みワークロードで、毎秒最大約8,000回の操作を実行できます。この制限を超えると、Snowflakeはスループットを低下させる可能性があります。詳細については、クォータとスロットリングをご参照ください。

Time Travel

Time Travel クエリは、以下の制限事項付きでハイブリッドテーブルに対してサポートされています。

AT 句では、 TIMESTAMP パラメーターのみがサポートされます。OFFSET、 STATEMENT、 STREAM パラメーターはサポートされません。
- TIMESTAMP パラメーターの値は、同じデータベースに属するすべてのテーブルで同じでなければなりません。テーブルが異なるデータベースに属している場合は、 TIMESTAMP の値が異なる場合があります。
- クローニングはハイブリッドテーブルでは一般的にサポートされていないため、 CREATE TABLE ... CLONE で AT 句を指定することはできません。
BEFORE 句はサポートされません。
Time Travelに依存する UNDROP TABLE コマンドはサポートされていません。

トランザクション

ハイブリッドテーブルの場合、トランザクションスコープはハイブリッドテーブルが存在するデータベースです。トランザクションで参照されているすべてのハイブリッドテーブルは同じデータベースに存在する必要があります。同じトランザクション内の標準的なSnowflakeテーブルはこの制限の影響を受けず、異なるデータベースに存在してもかまいません。

一時スキーマとデータベース

仮または一時的なハイブリッド・テーブルは作成できません。また、一時スキーマやデータベース内にハイブリッド・テーブルを作成することはできません。

Tri-Secret Secure

Snowflakeアカウントで Tri-Secret Secure の使用が有効になっている場合、ハイブリッドテーブルは使用できません。ハイブリッドテーブルを使用する前に Snowflakeサポートに連絡して、 Tri-Secret Secure に対してSnowflakeアカウントでが有効になっているかどうかを確認してください。

UNDROP

ハイブリッドテーブルでは、 UNDROP はサポートされていません。その他の情報は次のとおりです。

UNDROP SCHEMA および UNDROP DATABASE はハイブリッドテーブルを含むエンティティに対しては成功しますが、それらのハイブリッドテーブルと関連する制約とインデックスは復元できません。
TABLES ビューの DELETED 列には、削除時刻が親エンティティの UNDROP 時刻として表示されます。
ACCESS_HISTORY ビューには、親エンティティの DROP/UNDROP のエントリがありますが、ハイブリッドテーブルのエントリはありません。