Hologres:Hologres SQL ステートメントに関するよくある質問

エラー： failed to import foreign schema from odps: Can't find file system factory

• 原因： 設定エラーにより、Hologres が MaxCompute テーブルのファイルシステムにアクセスできません。

• 解決策： 外部サーバーと外部テーブルの設定を確認するか、データを Hologres 内部テーブルにインポートしてください。

エラー： Failed to import foreign schema from ODPS: Authorization Failed: xxx

• 原因： 現在のアカウントには、指定された MaxCompute テーブルに対する必要な権限がありません。

• 解決策： MaxCompute でアカウントに必要な権限を付与してください。詳細については、「コマンドを使用したユーザー権限の管理」をご参照ください。

エラー： failed to import foreign schema from odps:Table not found -xxx

• 原因： 指定されたテーブルが MaxCompute に存在しません。

• 解決策： MaxCompute でテーブル名とプロジェクトが正しいことを確認してください。

エラー： Update row with Key (id)=(xxxx) multiple times or duplicate key value violates unique constraint

• 原因：書き込みデータに重複するプライマリキー値が含まれているため、一意性制約に違反します。

• 解決策：

  • INSERT 文でエラーが発生した場合は、INSERT INTO xx ON CONFLICT 構文を使用してプライマリキーの重複を排除してください。詳細については、「INSERT ON CONFLICT (アップサート)」をご参照ください。

  • このエラーが INSERT...ON CONFLICT 文で発生した場合、ソースデータ自体に重複するプライマリキーが含まれています。詳細については、「一般的なエラー」をご参照ください。

  • このエラーは、テーブルの Time to Live (TTL) が期限切れで、期限切れのデータがまだ物理的に削除されていない場合にも発生する可能性があります。この場合は、hg_remove_duplicated_pk 関数を使用して重複データをクリーンアップしてください。詳細については、「一般的なエラー」をご参照ください。

エラー： ERROR: new row for relation violates partition constraint

• 原因：子パーティションテーブルに挿入するデータが、パーティション値の定義と一致していません。例えば、'20240110' 用に定義されたパーティションに、'20240110' より大きいパーティション値を持つ行を挿入すると、このエラーが発生します。例：

  CREATE TABLE public.tbl_20240110 PARTITION OF public.tbl FOR VALUES IN('20240110');
  
  INSERT INTO public.tbl_20240110 SELECT * FROM odps_tbl where sale_date >'20240110';
  
  error: new row for relation "tbl_20240110" violates partition constraint
  

• 解決策：子パーティションテーブルに書き込むデータが、パーティション制約を満たしていることを確認してください。

エラー： null value in column "xxx" violates not-null constraint

• 原因：NOT NULL 制約が設定されている列に NULL 値が書き込まれました。

• 解決策：その列に NULL 値を含む行を削除してから、書き込み操作をリトライしてください。

エラー： Dispatch query failed: Table not found

• 原因： テーブルが存在しません。これは通常、テーブルが最近作成されてそのメタデータがまだ伝播していない場合、またはクエリ実行中にテーブルに対して TRUNCATE や DROP 操作が実行された場合に発生します。

• 解決策： HoloWeb の Query Insight を使用して、TRUNCATE や DROP などの同時 DDL 操作を確認してください。競合を解決してから、クエリをリトライしてください。クエリが実行中のテーブルに対して DDL 操作を実行することは避けてください。詳細については、「Query Insight」をご参照ください。

エラー: ERROR: canceling statement due to statement timeout

• 原因：クエリの実行時間が、クライアントで設定されたステートメントタイムアウトを超過しました。

• 解決策：クエリを最適化して実行時間を短縮するか、タイムアウト期間を延長してください。タイムアウト設定の詳細については、「クエリの管理」をご参照ください。

エラー: ERROR: Query:[xxx] Get result failed: canceling statement due to user request

• 原因：クエリがキャンセルされました。これは通常、実行中にテーブルに対して DROP または TRUNCATE 操作が実行されたためです。

• 解決策：HoloWeb の Query Insight を使用して、競合する DDL 操作がないか確認してください。詳細については、「Query Insight」をご参照ください。クエリ実行中に DDL 操作を実行しないようにしてください。

エラー: query is cancelled Cannot find index full ID:xxx (table id: x, index id: x) in storages or it is deleting

• 原因：実行中に、クエリ対象のテーブルのいずれかに対して TRUNCATE または DROP 操作が実行されました。これによりテーブル ID が変更され、クエリがキャンセルされました。

• 解決策：Query Insight を使用して、クエリと同時に TRUNCATE または DROP 操作が実行されたかどうかを確認してください。詳細については、「Query Insight」をご参照ください。

エラー: Feature not supported: insert into parent table

• 原因：Hologres では、親パーティションテーブルへのデータの直接挿入はサポートされていません。

• 解決策：代わりに、特定の子パーティションテーブルにデータを挿入してください。詳細については、「CREATE PARTITION TABLE」をご参照ください。

エラー: SELECT INTO is not supported now.

• 原因：Hologres では、SELECT INTO 構文はサポートされていません。

• 解決策：データを挿入するには、INSERT INTO SELECT 構文を使用してください。詳細については、「INSERT」をご参照ください。

エラー: ALTER TABLE CHANGE OWNER is not supported in SLPM (Schema-Level Permission Mode)

• 原因：スキーマレベル権限モデル (SLPM) では、ALTER TABLE を使用してテーブル所有者を変更することはできません。

• 解決策：SLPM では、テーブル所有者はユーザーグループです。ユーザーの権限を変更するには、ユーザーグループからユーザーを削除してください。詳細については、「ユーザーグループからのユーザーの削除」をご参照ください。

エラー: Feature not supported: INSERT ON CONFLICT RETURNING

• 原因：Hologres では、INSERT ON CONFLICT RETURNING 構文はサポートされていません。

• 解決策：RETURNING 句を含まない INSERT ON CONFLICT 構文を使用してください。詳細については、「INSERT ON CONFLICT (アップサート)」をご参照ください。

エラー: ERROR: INSERT in ddl transaction is not supported now

• 原因：デフォルトでは、Hologres は BEGIN...COMMIT トランザクションブロック内での INSERT などの DML ステートメントをサポートしていません。例：

  BEGIN;
  INSERT xxx
  commit;
  ERROR: INSERT in ddl transaction is not supported now

• 解決策：トランザクションの外で INSERT ステートメントを実行するか、DML トランザクションを有効にしてください。詳細については、「SQL トランザクション機能」をご参照ください。

エラー: Creating publication with table that without binlog is not supported now

• 原因：Binlog が有効になっていないテーブルに対してパブリケーションを作成しようとしました。パブリケーションでは、データ変更をサブスクライブするために Binlog が必要です。

• 解決策：パブリケーションを作成する前に、テーブルで Binlog を有効にしてください。Binlog が有効になっているテーブルに対してのみパブリケーションを作成できます。詳細については、「JDBC を使用した Hologres Binlog の利用」をご参照ください。

エラー: Feature not supported: INSERT on conflict contains un-unique column

• 原因：INSERT ON CONFLICT ステートメントのコンフリクトターゲットにはプライマリキーのみを指定できます。エラーメッセージでは "un-unique column" (一意でない列) と表示されることがありますが、実際にはプライマリキー以外の列 (UNIQUE 制約を持つ列を含む) はコンフリクトターゲットとしてサポートされていません。

• 解決策：INSERT ON CONFLICT のコンフリクトターゲットには、プライマリキー列のみを指定してください。

エラー: Feature not supported: UPDATE with shard keys

• 原因：Hologres では、プライマリキーまたは分散キー列に対する UPDATE 操作はサポートされていません。Hologres の分散キーは、エラーメッセージで言及されているシャードキー (shard key) に相当します。

• 解決策：プライマリキーまたは分散キー列を更新しないでください。これらの値を変更するには、古い行を DELETE して、新しい行を INSERT する必要があります。

エラー: time before 1925 not supported

• 原因：時間関連の関数は、デフォルトで 1925 年から 2282 年までの範囲をサポートしています。この範囲外の値はエラーの原因となります。

• 解決策：to_char、to_date、to_timestamp などの関数でより広い時間範囲を有効にするには、SQL ステートメントの前に hg_experimental_functions_use_pg_implementation GUC パラメーターを設定してください。詳細については、「日付と時刻の関数」をご参照ください。

エラー: Group by key is type of imprecise not supported

• 原因：GROUP BY 句が、FLOAT などの不正確なデータ型の列を参照しています。

• 解決策：GROUP BY 句では、FLOAT の代わりに正確なデータ型を使用してください。

エラー: CREATE TABLE is not supported for current instance

• 原因：現在のインスタンスは共有クラスターインスタンス (エンドポイントが hgmc で始まる、例： hgmc-cn-xxwwwkkk)、またはセカンダリインスタンスです。エンドポイントは Hologres コンソールで確認できます。共有クラスターインスタンスは外部テーブルのみをサポートし、内部テーブルはサポートしていません。セカンダリインスタンスは読み取り専用です。

• 解決策：

  • 共有クラスターインスタンスを使用している場合は、外部テーブル構文を使用して外部テーブルを作成してください。詳細については、「CREATE FOREIGN TABLE」をご参照ください。または、専有インスタンスで内部テーブルを作成してください。

  • セカンダリインスタンスを使用している場合は、プライマリインスタンスでテーブルを作成する必要があります。

エラー: ALTER TABLE ALTER COLUMN SET TYPE is not supported now

• 原因：Hologres では、ALTER TABLE を使用した列データ型の変更はサポートされていません。

• 解決策：列の型を変更するには、目的の型を指定してテーブルを再作成してください。

エラー: ERROR: Currently materialized view does not support aggregate on expressions, only support single column

• 原因：単一テーブルのマテリアライズドビューでは、式に対する集計はサポートされていません。

• 解決策：単一テーブルのマテリアライズドビューでは式の使用を避けてください。単一列の集計のみを使用してください。詳細については、「SQL を使用したマテリアライズドビューの管理」をご参照ください。

エラー: ERROR: SELECT rule's target list has too few entries

• 原因：リアルタイムマテリアライズドビューでは、式を使用したクエリがサポートされていない場合があります。

• 解決策：リアルタイムマテリアライズドビューでは式の使用を避けてください。詳細については、「SQL を使用したマテリアライズドビューの管理」をご参照ください。

エラー: TransactionRowStore::DumpFlushDelta Not implemented

• 原因：現在の Hologres バージョンには、DELETE FROM table USING 構文に関する実装上の制限があり、このエラーが発生します。

• 解決策：バッチ削除で USING 句を使用しないように、SQL ステートメントを書き直してください。代わりに、次の構文を使用してください：

  DELETE FROM table WHERE (col1, col2) IN ((val1, val2), ...);

エラー：column xxx does not exist

• 原因：指定されたカラムはテーブルに存在しません。

• 解決策：SQL ステートメント内のカラム名が正しいことを確認してください。

エラー：Table group xxx does not exist

• 原因：指定されたテーブルグループは存在しません。

• 解決策：テーブルを作成する際に既存のテーブルグループを指定するか、最初にテーブルグループを作成してください。

エラー：The specified partition does not exist

• 原因：このエラーは通常、データの書き込みまたは更新中に、ターゲットの子パーティションテーブルが存在しない場合に発生します。

• 解決策：データを書き込む前に、必要な子パーティションを作成してください。

エラー：create binlog reader failed: Fail to find any shards, please check if the table group is in current virtual warehouse

• 原因：指定されたテーブルグループは現在の仮想ウェアハウスにはロードされていません。

• 解決策：テーブルグループが仮想ウェアハウスにロードされていることを確認してください。ロードされていない場合は、ロードされるように仮想ウェアハウスを構成してください。詳細については、「仮想ウェアハウスにデータへのアクセスを認可する」をご参照ください。

エラー： Total memory used by all existing queries exceeded memory limitation

• 原因：クエリがメモリ制限を超過し、メモリ不足 (OOM) エラーが発生しました。

• 解決策: 詳細については、「OOM エラーのトラブルシューティング」をご参照ください。

エラー：internal error: Datasets has different schema

• 原因：結合するデータセット (UNION や INSERT...SELECT ステートメントなど) のスキーマで、カラム数、順序、またはデータ型が一致していません。

• 解決策：ステートメントのすべての部分で、カラム数、順序、データ型が一貫していることを確認してください。

エラー： value too long for type character varying(xxx)

• 原因：データの値が、列に定義された character varying(n) の長さ制限を超えています。

• 解決策：データを切り捨てるか変換するか、 VARCHAR の長さ制限を増やすか、または列の型を TEXT に変更してください。

エラー： Exceeds the partition limitation of 512, current match xxx partitions.

• 原因： クエリが MaxCompute 外部テーブルで 512 個を超えるパーティションをスキャンしており、デフォルトの制限を超えています。

• 解決策： パーティションフィルター条件を追加するか、次の GUC パラメーターを使用してパーティションスキャン制限を増やしてください。詳細については、「MaxCompute 統合に関するよくある質問」をご参照ください。

  set hg_foreign_table_max_partition_limit =xx;

エラー： Build desc failed: Exceeds the scan limitation of 200 GB, current scan xxx GB.

• 原因： MaxCompute 外部テーブルのスキャンデータ量が 200 GB の制限を超えています。

• 解決策：

  • フィルター条件を追加して、スキャンデータ量を減らしてください。

  • データを Hologres 内部テーブルにインポートしてください。内部テーブルにはスキャンサイズ制限はありません。

エラー：syntax error at or near "xxxxx"

• 原因：SQL ステートメントに構文エラーがあります。

• 解決策：SQL の構文を確認し、修正してください。

エラー： DISTINCT is not implemented for window functions

• 原因： Hologres では現在、ウィンドウ関数での DISTINCT キーワードはサポートされていません。

• 解決策：ウィンドウ関数から DISTINCT キーワードを削除してください。

エラー： ERROR:function xxx does not exist

• 原因：必要な拡張がインストールされていないか、関数呼び出しの構文が無効です。

• 解決策：必要な拡張をインストールするか、関数の構文を修正してください。

エラー： ERROR: function jsonb_set(json, text[], jsonb, boolean) does not exist

• 原因：引数の型が JSONB_SET 関数シグネチャと一致していません。

• 解決策： JSONB_SET の最初の引数が JSON 型ではなく JSONB 型であることを確認してください。詳細については、「JSON および JSONB データ型」をご参照ください。

エラー：You have NO privilege 'odps:Select' on xxx

• 原因：現在のアカウントには、MaxCompute テーブルをクエリするための権限がありません。

• 解決策：MaxCompute でアカウントに必要な権限を付与してください。

エラー：The sensitive label of column 'xxx' is 2, but your effective label is 0

• 原因：現在のアカウントは、MaxCompute テーブルの一部の列にのみアクセスできます。

• 解決策：MaxCompute でより広範な列レベルの権限を付与するか、アクセス権のある列のみをクエリしてください。認可の詳細については、「コマンドによるユーザー権限の管理」をご参照ください。

エラー： extension "xxxxx" already exists

• 原因: 指定されたエクステンションはデータベースに既に存在します。

• 解決策: エクステンションはすでにインストールされています。アクションは不要です。このエラーを回避するには、CREATE EXTENSION IF NOT EXISTS を使用します。

エラー： invalid input syntax for type numeric: ""

• 原因： NUMERIC 列には、数値として解析できない空文字列などの無効なデータが含まれています。

• 解決策： ソースデータをクリーンアップし、NUMERIC 型に準拠させてください。たとえば、空文字列を NULL または 0 に変換します。

エラー： invalid input syntax for integer: xxx

• 原因： INT 列には、整数として解析できないデータが含まれています。

• 解決策： 無効なデータをクリーンアップしてください。

Error: missing data for column "xxx". failed to query next

• 原因：データファイルの形式が正しくありません。これは、多くの場合、データに COPY コマンドで指定した区切り文字 (カンマやスペースなど) が含まれているために列数が不一致となり、発生します。

• 解決策：データをクリーンアップするか、データ値に含まれない別の区切り文字を使用してください。

Error: ERROR: INSERT has more expressions than target columns

• 原因：INSERT 文の値の数が、対象テーブルの列数を超えています。

• 解決策：INSERT 文の値の数が、対象列の数と一致することを確認してください。

エラー： bigint out of range

• 原因： 値が BIGINT 型の有効な範囲を超えています。

• 解決策： データが BIGINT の範囲 (-9223372036854775808 から 9223372036854775807) 内にあることを確認するか、より大きな値には NUMERIC 型を使用してください。

エラー： numeric field overflow in function round

• 原因： NUMERIC の値が、定義された精度を超えています。

• 解決策： データに合わせて NUMERIC 列の精度を調整するか、定義された精度に収まるようにデータをクリーンアップしてください。

エラー： InsertOverwrite insert select table data failed : column a.unsign_type does not exist

• 原因：指定されたカラムがテーブルに存在しないか、パラメーター名が正しくありません。

• 解決策： SQL 構文を確認して修正してください。

エラー： mismatched properties: table orientation is "column" but storage format is "sst"

• 原因：テーブルプロパティが一致していません。列指向ストレージが指定されていますが、ストレージフォーマットに互換性のない SST が設定されています。

• 解決策： SQL ステートメントを確認して修正してください。

エラー： invalid value "" for "yyyy". Value must be an integer.

• 原因：データが期待される日時フォーマットに準拠していません。

• 解決策：書き込む前に、データに有効な日時の値が含まれていることを確認してください。

エラー： 「UTF8」 エンコーディングの不正なバイトシーケンス： 0xe9 0x80

エラー： relation "xxxx" already exists

• 原因：指定されたリレーションはデータベースに既に存在します。

• 解決策：別のリレーション名を使用するか、CREATE TABLE IF NOT EXISTS を使用してエラーを回避してください。

Error: character with byte sequence 0xe4 0x9e 0xab in encoding "UTF8" has no equivalent in encoding "GBK"

• 原因： UTF-8 の文字に、変換先の GBK エンコーディングで対応する文字がありません。

• 解決策： 無効なデータをクリーンアップしてください。

エラー： column "xxx" must appear in the GROUP BY clause or be used in an aggregate function

• 原因： SELECT リスト内の非集約列が GROUP BY 句に含まれていません。SELECT リスト内のすべての列は、GROUP BY 句に含めるか、集約関数内で使用する必要があります。

• 解決策： 列を GROUP BY 句に追加するか、集約関数内で使用してください。

エラー： SET_TABLE_PROPERTY and CREATE TABLE statement are not in the same transaction for table

• 原因： CREATE TABLE と call set_table_property ステートメントが、同一のトランザクション内にありません。

• 解決策： CREATE TABLE とすべての call set_table_property ステートメントを、同一のトランザクションブロックでラップしてください。例：

  begin;
  CREATE TABLE tbl (
   xxxx
  );
  call set_table_property('tbl', 'orientation', 'xx');
  call set_table_property('tbl', 'distribution_key', 'xxx');
  commit;

エラー： 列参照「xxx」はあいまいです

• 原因: JOIN クエリ内の列名が複数のテーブルに存在するため、あいまいです。たとえば、SELECT id FROM t1 INNER JOIN t2 ON t1.id=t2.id では、SELECT 句の id は、t1 または t2 のどちらかを参照する可能性があるため、あいまいです。

• 解決策: テーブル名またはエイリアス (例: t1.id) で列を修飾します。

Error: column "xxx" specified more than once

• 原因： CREATE TABLE ステートメントで、同じカラム名が複数回指定されています。

• 解決策： CREATE TABLE ステートメントから重複したカラムを削除してください。

エラー：数値型の無効な定義

• 原因： NUMERIC または DECIMAL 列の定義で精度が指定されていません。

• 解決策： NUMERIC または DECIMAL 列に、NUMERIC(38, 18) のように精度を指定してください。

エラー： cannot cast type date to integer

• 原因：DATE 型は INTEGER 型にキャストできません。

• 解決策：SQL 構文を修正し、有効な型キャストを使用してください。

Error: schema "xxxx" does not exist

• 原因：指定したスキーマがデータベースに存在しません。

• 解決策：SQL ステートメント内のスキーマ名が正しいことを確認するか、先にスキーマを作成してください。

Error: internal error: Connect timeout, err: std_exception: Connection refused

• 原因：Hologres インスタンスが利用できない、または応答していません。

• 解決策：Hologres インスタンスの停止について調査するため、サポートチケットを提出してください。

列名が数字で始まる場合は、次の例に示すように、クエリ内で二重引用符で囲む必要があります。

select bizdate,"1_day_active_users","7_day_active_users" from t_active_users;