Query Service トラブルシューティングガイド

SELECT * FROM customers LIMIT 0;

• クエリを CTAS クエリに変換 実行をスケジュールします。 実行のスケジュールは、次のいずれかを実行できます UI を使用 または API.
• 追加の フィルター条件.
• EXPLAIN コマンドを実行します。 詳細を収集するには
• データセット内のデータの統計を確認します。
• クエリを簡略化されたフォームに変換し、 準備済み文書.

• Experience Platform データセット （ UI の左側のナビゲーションでに移動） データセット ダッシュボード。
• データセット 参照 タブが開きます。 検索バーを使用して、使用可能なオプションを絞り込むことができます。 表示されたリストからデータセットを選択します。

• この データセットアクティビティ 画面が表示されます。 選択 データセットをプレビュー をクリックして、選択したデータセットから、XDM スキーマのダイアログと、フラット化されたデータの表形式表示を開きます。 詳しくは、 データセットドキュメントのプレビュー

• スキーマから任意のフィールドを選択し、統合された列にその内容を表示します。 列の名前は、ページの右側のコンテンツの上に表示されます。 このデータセットのクエリに使用するには、この名前をコピーする必要があります。

以下に関する詳細なガイダンスについては、ドキュメントを参照してください。 ネストされたデータ構造の操作方法 クエリエディターまたはサードパーティのクライアントを使用して、

処理中にクエリが停止する理由はいくつか考えられます。 正確な原因を突き止めるには、ケースバイケースで詳細な分析が必要です。 連絡先Adobeカスタマーサポート をこのプロセスに置き換えます。

Adobeカスタマーサポートの電話番号の完全なリスト は、「Adobe」ヘルプページで利用できます。 または、次の手順でオンラインヘルプを参照することもできます。

• に移動します。 https://www.adobe.com/ を設定します。
• 上部ナビゲーションバーの右側で、「 ログイン.

• ご使用のAdobeライセンスに登録されているAdobe IDとパスワードを使用してください。
• 選択 ヘルプとサポート 上部ナビゲーションバーから。

ドロップダウンバナーが表示され、 ヘルプとサポート 」セクションに入力します。 選択 お問い合わせ をクリックして、Adobeの Customer Care Virtual Assistant を開くか、 エンタープライズサポート 大規模組織向けの専用ヘルプ

詳しくは、 匿名ブロックドキュメント を参照してください。

1. 既存の Adobe定義関数 を使用して、使用例のニーズが満たされているかどうかを特定します。
2. 前の提案が使用例を満たさない場合は、 窓関数. 窓関数は、シーケンス内のすべてのイベントを調べます。 また、履歴データを確認し、任意の組み合わせで使用することもできます。

複数のクエリを取得するには、GETコマンドを使用します。 API の呼び出し方法に関する情報については、 API 呼び出しのサンプルドキュメント.

応答から、調査するクエリを識別し、そのクエリを使用して別のGETリクエストを作成します id の値です。 すべての手順については、 ID ドキュメントによるクエリの取得.

正常な応答は、HTTP ステータス 200 を返し、 errors 配列。 応答は短くなり、簡潔になりました。

{
    "isInsertInto": false,
    "request": {
                "dbName": "prod:all",
                "sql": "SELECT *\nFROM\n  accounts\nLIMIT 10\n"
            },
    "clientId": "8c2455819a624534bb665c43c3759877",
    "state": "SUCCESS",
    "rowCount": 0,
    "errors": [{
      'code': '58000',
      'message': 'Batch query execution gets : [failed reason ErrorCode: 58000 Batch query execution gets : [Analysis error encountered. Reason: [sessionId: f055dc73-1fbd-4c9c-8645-efa609da0a7b Function [varchar] not defined.]]]',
      'errorType': 'USER_ERROR'
      }],
    "isCTAS": false,
    "version": 1,
    "id": "343388b0-e0dd-4227-a75b-7fc945ef408a",
}

この クエリサービス API リファレンスドキュメント では、使用可能なすべてのエンドポイントに関する詳細情報を提供します。

次の例は、CTAS 構文と struct データ型の使用方法を示しています。

CREATE TABLE table_name WITH (SCHEMA='schema_name')

AS SELECT '1' as _id,

 STRUCT

  ('2021-02-17T15:39:29.0Z' AS taskActualCompletionDate,

    '2020-09-09T21:21:16.0Z' AS taskActualStartDate,

    'Consulting' AS taskdescription,

    '5f6527c10011e09b89666c52d9a8c564' AS taskguide,

    'Stakeholder Consulting Engagement' AS taskname,

    '2020-09-09T15:00:00.0Z' AS taskPlannedStartDate,

    '2021-02-15T11:00:00.0Z' AS taskPlannedCompletionDate

  ) AS _workfront ;

また、次のような小さなクエリを使用して、データセットにデータが含まれていることを確認できます。

SELECT count(1) FROM myTableName

また、の実行方法に関するガイダンスについては、ドキュメントを参照してください UI でのスケジュール済みクエリ そして API.

次に、 Query Editor. これらは、 Query Service API:
既に作成、保存、実行されたクエリにのみスケジュールを追加できます。
あなた できません パラメータ化クエリにスケジュールを追加します。
スケジュールクエリ できません には、匿名ブロックが含まれています。
スケジュールできるのは 1 つ UI を使用したクエリテンプレート。 クエリテンプレートにスケジュールを追加する場合は、API を使用する必要があります。 API を使用してスケジュールが既に追加されている場合、UI を使用してスケジュールを追加することはできません。

SELECT * FROM <table> WHERE 1=0

例えば、一時テーブルを作成できます。

CREATE temp TABLE temp_dataset AS
SELECT *
FROM actual_dataset
WHERE 1 = 0;

次に、一時テーブルを次のように使用できます。

INSERT INTO temp_dataset
SELECT a._company AS _company,
a._id AS _id,
a.timestamp AS timestamp
FROM actual_dataset a
WHERE timestamp >= TO_TIMESTAMP('2021-01-21 12:00:00')
AND timestamp < TO_TIMESTAMP('2021-01-21 13:00:00')
LIMIT 100;

クエリサービスは、指定されたタイムスタンプを UTC 形式に変換したり、UTC 形式から変換したりするための組み込みの SQL 関数をサポートしています。 両方の to_utc_timestamp() そして from_utc_timestamp() メソッドには 2 つのパラメーターを指定します。タイムスタンプとタイムゾーン。

UTC タイムスタンプに変換

この to_utc_timestamp() メソッドは指定されたパラメーターを解釈し、変換します ローカルタイムゾーンのタイムスタンプに （UTC 形式） 例えば、韓国のソウルのタイムゾーンは、UTC/GMT +9 時間です。 日付のみのタイムスタンプを指定すると、メソッドではデフォルト値の午前 0 時が使用されます。 タイムスタンプとタイムゾーンは、その地域の時刻から地域の UTC タイムスタンプに変換されます。

SELECT to_utc_timestamp('2021-08-31', 'Asia/Seoul');

クエリは、ユーザーのローカル時間のタイムスタンプを返します。 この場合、ソウルは 9 時間先なので、前日の午後 3 時です。

2021-08-30 15:00:00

別の例として、指定されたタイムスタンプが 2021-07-14 12:40:00.0 の Asia/Seoul timezone。返される UTC タイムスタンプは次のようになります。 2021-07-14 03:40:00.0

クエリサービス UI で提供されるコンソール出力は、より人間が読み取り可能な形式です。

8/30/2021, 3:00 PM

UTC タイムスタンプからの変換

この from_utc_timestamp() メソッドは、指定されたパラメーターを解釈します ローカルタイムゾーンのタイムスタンプから およびは、目的の地域の同等のタイムスタンプを UTC 形式で提供します。 次の例では、時間はユーザーのローカルタイムゾーンの午後 2 時 40 分です。 変数として渡されるソウルタイムゾーンは、ローカルタイムゾーンの 9 時間前です。

SELECT from_utc_timestamp('2021-08-31 14:40:00.0', 'Asia/Seoul');

クエリは、パラメーターとして渡されたタイムゾーンのタイムスタンプを UTC 形式で返します。 結果は、クエリを実行したタイムゾーンより 9 時間早くなります。

8/31/2021, 11:40 PM

時系列データはどのようにフィルタリングする必要がありますか。

SELECT a._company  AS _company,
       a._id       AS _id,
       a.timestamp AS timestamp
FROM   dataset a
WHERE  timestamp >= To_timestamp('2021-01-21 12:00:00')
       AND timestamp < To_timestamp('2021-01-21 13:00:00')

例えば、以下に示すように、時間コンポーネントが見つからない場合、次のエラーが発生します。

SELECT * FROM ABC
WHERE timestamp = CAST('07-29-2021' AS timestamp)

の正しい使用方法 CAST 演算子を次に示します。

SELECT * FROM ABC
WHERE timestamp = CAST('07-29-2021 00:00:00' AS timestamp)

を使用する代わりに、 NOT INを使用する場合、 NOT EXISTS または LEFT OUTER JOIN.

例えば、次のテーブルが作成されているとします。

CREATE TABLE T1 (ID INT)
CREATE TABLE T2 (ID INT)
INSERT INTO T1 VALUES (1)
INSERT INTO T1 VALUES (2)
INSERT INTO T1 VALUES (3)
INSERT INTO T2 VALUES (1)
INSERT INTO T2 VALUES (2)

を使用している場合、 NOT EXISTS 演算子を使用する場合は、 NOT IN 演算子を使用するには、次のクエリを使用します。

SELECT ID FROM T1
WHERE NOT EXISTS
(SELECT ID FROM T2 WHERE T1.ID = T2.ID)

または、 LEFT OUTER JOIN 演算子を使用する場合は、 NOT IN 演算子を使用するには、次のクエリを使用します。

SELECT T1.ID FROM T1
LEFT OUTER JOIN T2 ON T1.ID = T2.ID
WHERE T2.ID IS NULL

PSQL クライアントを使用する場合、クエリの結果を保存する方法は 2 つあります。 以下を使用して、 COPY TO コマンドを使用するか、次の形式を使用してステートメントを作成します。

SELECT column1, column2
FROM <table_name>
\g <table_name>.out

使用に関するガイダンス COPY TO command は、 SQL 構文リファレンスドキュメントに記載されています。

SELECT * FROM prod_table LIMIT 1;

次のように記述します。

SELECT * FROM prod_table
WHERE
timestamp >= to_timestamp('2022-07-22')
and timestamp < to_timestamp('2022-07-23');

方法の詳細については、ドキュメントを参照してください。 資格情報を使用して外部クライアントに接続.

ダッシュボードの応答時間を改善する場合は、Business Intelligence(BI) サーバーを、クエリサービスと BI ツールの間のキャッシュレイヤーとして実装する必要があります。 通常、ほとんどの BI ツールには、サーバーに対する追加のオファーがあります。

キャッシュサーバーレイヤーを追加する目的は、クエリサービスからのデータをキャッシュし、ダッシュボードで応答を高速化するためにそれを利用することです。 実行されるクエリの結果は、毎日 BI サーバーにキャッシュされるので、この処理が可能です。 次に、キャッシュサーバーは、同じクエリを持つすべてのユーザーに対してこれらの結果を提供し、待ち時間を短縮します。 この設定の明確化には、使用しているユーティリティまたはサードパーティツールのドキュメントを参照してください。

ErrorCode: 58000 Internal System Error [Invalid table your_table_name. historyMeta can be used on datalake tables only.]

このエラーは、クエリに戻り値がないために発生しました。 この動作が修正され、次のメッセージが返されるようになりました。

Query complete in {timeframe}. 0 rows returned.