常見問答

本檔案提供查詢服務常見問題的解答,並提供使用查詢服務時常見錯誤碼的清單。 如需Adobe Experience Platform中其他服務的相關問題和疑難排解,請參閱Experience Platform疑難排解指南

下列常見問題的解答清單分為下列類別:

一般查詢服務問題 general

本節包含有關效能、限制和程式的資訊。

我可以關閉查詢服務編輯器中的自動完成功能嗎?

回答
不適用。 編輯器目前不支援關閉自動完成功能。

為什麼當我輸入查詢時,查詢編輯器有時會變慢?

回答
一個可能的原因是自動完成功能。 此功能會處理某些中繼資料命令,在查詢編輯期間偶爾會讓編輯器速度變慢。

我可以將Postman用於查詢服務API嗎?

回答
可以,您可以使用Postman (免費的協力廠商應用程式)將所有AdobeAPI服務視覺化並與其互動。 請觀看Postman 設定指南,瞭解如何在Adobe Developer Console中設定專案及取得與Postman搭配使用所需的所有認證的逐步指示。 請參閱有關啟動、執行和共用 Postman 集合🔗的指南的官方檔案。

透過UI從查詢傳回的最大列數是否有限制?

回答
是的,除非在外部明確指定限制,否則Query Service在內部套用50,000列的限制。 如需詳細資訊,請參閱互動式查詢執行的指南。

我可以使用查詢來更新列嗎?

回答
在批次查詢中,不支援更新資料集中的列。

查詢產生的輸出是否有資料大小限制?

回答
不適用。 資料大小沒有限制,但互動式工作階段有10分鐘的查詢逾時限制。 如果查詢是以批次CTAS方式執行,則10分鐘逾時不適用。 如需詳細資訊,請參閱互動式查詢執行的指南。

如何略過SELECT查詢的輸出列數限制?

回答

若要略過輸出列限制,請在查詢中套用「LIMIT 0」。 例如:

code language-sql
SELECT * FROM customers LIMIT 0;

如何防止我的查詢在10分鐘內逾時?

回答

如果查詢逾時,建議使用下列一或多個解決方案。

如果同時執行多個查詢,是否有任何問題或影響查詢服務的效能?

回答
不適用。 查詢服務具有自動縮放功能,可確保同時進行的查詢不會明顯影響服務的效能。

我可以使用保留關鍵字做為欄名稱嗎?

回答
某些保留關鍵字無法當做資料行名稱使用,例如, ORDERGROUP BYWHEREDISTINCT。 如果您想使用這些關鍵字,則必須逸出這些欄。

如何從階層式資料集找到欄名稱?

回答

下列步驟說明如何透過UI顯示資料集的表格檢視,包括平面化表單中的所有巢狀欄位和欄。

  • 登入Experience Platform後,請在UI的左側導覽中選取​ 資料集 ​以導覽至資料集儀表板。
  • 資料集瀏覽索引標籤開啟。 您可以使用搜尋列來調整可用選項。 從顯示的清單中選取資料集。

Platform UI中的資料集儀表板,具有搜尋列和醒目提示的資料集。

  • 資料集活動畫面會出現。 選取​ 預覽資料集 ​以開啟XDM結構描述的對話方塊,以及所選資料集中平面化資料的表格檢視。 如需詳細資訊,請參閱預覽資料集檔案

資料集儀表板的資料集活動索引標籤中反白顯示預覽資料集。

  • 從結構描述中選取任何欄位,以在平面化欄中顯示其內容。 欄的名稱會顯示在頁面右側其內容的上方。 您應該複製此名稱以用來查詢此資料集。

平面化資料的XDM結構描述和表格檢視。 巢狀資料集的欄名稱會在UI中反白顯示。

請參閱檔案,以取得有關如何使用查詢編輯器或協力廠商使用者端處理巢狀資料結構的完整指引。

如何在包含陣列的資料集上加快查詢速度?

回答
若要改善包含陣列的資料集上的查詢效能,您應在執行階段將陣列展開為CTAS查詢,然後進一步探索以取得改善其處理時間的機會。

為什麼我的CTAS查詢只對少數列進行數小時後仍在處理?

回答

如果查詢在非常小的資料集上花費了很長的時間,請聯絡客戶支援。

查詢在處理期間卡住的原因不勝列舉。 若要判斷確切原因,需要逐案進行深入分析。 連絡Adobe客戶支援以成為此程式。

如何聯絡Adobe客戶支援? customer-support

回答

Adobe客戶支援電話號碼的完整清單可在Adobe說明頁面上取得。 或者,您也可以完成下列步驟,線上上取得說明:

已登入的Adobe網站反白顯示。

  • 使用已在您的Adobe授權中註冊的Adobe ID和密碼。
  • 從上方導覽列中選取​ 說明與支援

上方導覽列的下拉式功能表,包含[說明及支援]、[企業支援]及[連絡我們]等標示專案。

會顯示包含說明與支援區段的下拉式橫幅。 選取​ 連絡我們 ​以開啟Adobe客戶服務虛擬助理,或選取​ 企業支援 ​以取得大型組織的專用說明。

如果前一個工作未成功完成,該如何實作循序工作序列,而不執行後續工作?

回答

匿名區塊功能可讓您連結一或多個依序執行的SQL敘述句。 它們也允許例外狀況處理的選項。

如需詳細資訊,請參閱匿名區塊檔案

如何在查詢服務中實作自訂歸因?

回答

實作自訂歸因的方式有兩種:

  1. 使用現有Adobe定義函式的組合,以識別是否符合使用案例需求。
  2. 如果前面的建議不符合您的使用案例,您應該使用視窗函式的組合。 視窗函式會依序檢視所有事件。 它們也可讓您檢閱歷史資料,並可用於任何組合。

我可以範本化查詢,以便輕鬆重複使用嗎?

回答
可以,您可以透過使用預先準備的陳述式將查詢範本化。 準備好的陳述式可最佳化效能,並避免重複重新剖析查詢。 如需詳細資訊,請參閱準備好的陳述式檔案

如何擷取查詢的錯誤記錄檔? error-logs

回答

若要擷取特定查詢的錯誤記錄,您必須先使用查詢服務API來擷取查詢記錄詳細資料。 HTTP回應包含調查查詢錯誤所需的查詢ID。

使用GET命令來擷取多個查詢。 有關如何呼叫API的資訊,請參閱範例API呼叫檔案

從回應中,識別您要調查的查詢,並使用其id值提出另一個GET要求。 完整的指示可在依ID擷取查詢中找到。

成功的回應傳回HTTP狀態200,並包含errors陣列。 為求簡潔,已縮短回應。

code language-json
{
    "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語法和結構資料型別:

code language-sql
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 ;

如何快速處理每天傳入系統的新資料?

回答
SNAPSHOT子句可用於根據快照識別碼逐步讀取資料表上的資料。 這是搭配增量負載設計模式使用的理想選擇,該設計模式只處理自上次負載執行以來已建立或修改的資料集中的資訊。 因此,它提高了處理效率,並且可同時用於串流和批次資料處理。

為什麼設定檔UI中顯示的數字與從設定檔匯出資料集計算出的數字存在差異?

回答

在輪廓圖示板中顯示的數字自上次快照起是準確的。 在設定檔匯出表格中產生的數字完全取決於匯出查詢。 因此,查詢符合特定對象資格的設定檔數量是造成這種差異的常見原因。

note note
NOTE
查詢包括歷史資料,而UI只會顯示目前的設定檔資料。

為什麼我的查詢傳回空的子集?我應該怎麼做?

回答

最可能的原因是您的查詢範圍太窄。 在您開始看到某些資料之前,您應該系統性地移除WHERE子句的區段。

您也可以使用小型查詢來確認您的資料集包含資料,例如:

code language-sql
SELECT count(1) FROM myTableName

我可以抽樣我的資料嗎?

回答
此功能目前正在進行中。 當功能準備發行時,將在發行說明中以及透過Platform UI對話方塊提供詳細資訊。

查詢服務支援哪些協助程式函式?

回答
Query Service提供數種內建的SQL Helper函式,以擴充SQL功能。 請參閱檔案,以取得查詢服務🔗所支援SQL函式的完整清單。

是否支援所有原生Spark SQL函式,或使用者是否僅限於Adobe提供的包裝函式Spark SQL函式?

回答
尚未在資料湖資料上測試所有開放原始碼Spark SQL函式。 測試並確認後,會將其新增至支援清單。 請參考支援的 Spark SQL 函式🔗的清單,以檢查特定函式。

使用者可以定義自己的使用者定義函式(UDF)來用於其他查詢嗎?

回答
由於資料安全考量,不允許使用UDF的自訂定義。

如果排程的查詢失敗,怎麼辦?

回答

首先,檢查記錄檔以找出錯誤的詳細資料。 有關在記錄檔中尋找錯誤的常見問題集區段,提供如何執行此動作的詳細資訊。

您也應該檢視檔案以瞭解如何在UI🔗中及透過API執行已排程的查詢。

請注意,使用Query Editor時,您只能將排程新增至已建立並儲存的查詢。 這不適用於Query Service API。

「已達工作階段上限」錯誤是什麼意思?

回答
「已達工作階段限制」表示已達貴組織允許的查詢服務工作階段數量上限。 請聯絡貴組織的Adobe Experience Platform管理員。

查詢記錄如何處理與已刪除資料集相關的查詢?

回答
查詢服務絕不會刪除查詢記錄。 這表示任何參考已刪除資料集的查詢都會因此傳回「沒有有效的資料集」。

如何只取得查詢的中繼資料?

回答

您可以執行傳回零列的查詢,以僅取得回應中的中繼資料。 此範例查詢只會傳回指定資料表的中繼資料。

code language-sql
SELECT * FROM <table> WHERE 1=0

如何快速反複處理CTAS (建立表格為選取)查詢而不將其實體化?

回答

您可以建立暫存表格,在具體化查詢以供使用之前,快速迭代和實驗查詢。 您也可以使用暫存表格來驗證查詢是否有效。

例如,您可以建立臨時表格:

code language-sql
CREATE temp TABLE temp_dataset AS
SELECT *
FROM actual_dataset
WHERE 1 = 0;

然後可以使用臨時表格,如下所示:

code language-sql
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時間戳記之間的時區?

回答

Adobe Experience Platform會以UTC (國際標準時間)時間戳記格式儲存資料。 UTC格式的範例為2021-12-22T19:52:05Z

Query Service支援內建的SQL函式,可將指定的時間戳記轉換成UTC格式或從UTC格式轉換。 to_utc_timestamp()from_utc_timestamp()方法都採用兩個引數:時間戳記和時區。

table 0-row-2 1-row-2 2-row-2
參數 說明
時間戳記 時間戳記可以用UTC格式或簡單的{year-month-day}格式寫入。 如果未提供時間,預設值為指定日期的凌晨的午夜。
時區 時區是以{continent/city})格式寫入。 它必須是可在公用網域TZ資料庫中找到的其中一個可辨識的時區代碼。

轉換為UTC時間戳記

to_utc_timestamp()方法會解譯指定的引數,並將其​ 轉換為UTC格式的當地時區 ​的時間戳記。 例如,韓國首爾的時區是UTC/GMT +9小時。 藉由提供僅限日期的時間戳記,方法會使用上午午夜的預設值。 時間戳記和時區會從該區域的時間轉換為UTC格式,再轉換為您當地區域的UTC時間戳記。

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

查詢會傳回以使用者當地時間為單位的時間戳記。 在此案例中,前一天下午3點,因為首爾比我們早9小時。

code language-none
2021-08-30 15:00:00

再舉一例,如果特定時間戳記是Asia/Seoul時區的2021-07-14 12:40:00.0,則傳回的UTC時間戳記將是2021-07-14 03:40:00.0

查詢服務UI中提供的主控台輸出是較易讀取的格式:

code language-none
8/30/2021, 3:00 PM

從UTC時間戳記轉換

from_utc_timestamp()方法會從您當地時區​ 的時間戳記中解譯指定的引數,並以UTC格式提供所需區域的對等時間戳記。 在以下範例中,該小時是使用者的當地時區中下午2:40。 以變數傳遞的首爾時區比當地時區早九小時。

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

針對作為引數傳遞的時區,查詢會傳回UTC格式的時間戳記。 結果會比執行查詢的時區提早九小時。

code language-none
8/31/2021, 11:40 PM

如何篩選時間序列資料?

accordion
回答

查詢時間序列資料時,應儘可能使用時間戳記篩選器,以進行更精確的分析。

note note
NOTE
日期字串​ 必須 ​的格式為yyyy-mm-ddTHH24:MM:SS

使用時間戳記篩選器的範例可檢視如下:

code language-sql
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')

如何正確使用CAST運運算元來轉換SQL查詢中的時間戳記?

回答

使用CAST運運算元轉換時間戳記時,您必須同時包含日期​ ​時間。

例如,遺漏時間元件(如下所示)將導致錯誤:

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

以下顯示CAST運運算元的正確用法:

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

我是否應該使用萬用字元(例如*)來取得資料集中的所有列?

回答
您無法使用萬用字元從資料列取得所有資料,因為查詢服務應視為​ 欄位存放區,而不是傳統的資料列式存放區系統。

我是否應該在SQL查詢中使用NOT IN

回答

NOT IN運運算元通常用於擷取在其他資料表或SQL陳述式中找不到的資料列。 如果比較的資料行接受NOT NULL,或您有大量的記錄,此運運算元可能會降低效能並傳回非預期的結果。

您可以使用NOT EXISTSLEFT OUTER JOIN,而不使用NOT IN

例如,如果您已建立下清單格:

code language-sql
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運運算元復寫:

code language-sql
SELECT ID FROM T1
WHERE NOT EXISTS
(SELECT ID FROM T2 WHERE T1.ID = T2.ID)

或者,如果您使用LEFT OUTER JOIN運運算元,可以使用下列查詢使用NOT IN運運算元復寫:

code language-sql
SELECT T1.ID FROM T1
LEFT OUTER JOIN T2 ON T1.ID = T2.ID
WHERE T2.ID IS NULL

我可以使用CTAS查詢建立具有雙底線名稱(類似於UI中顯示的名稱)的資料集嗎? 例如: test_table_001

回答
不會,這是跨Experience Platform的刻意限制,適用於所有Adobe服務,包括查詢服務。 結構描述和資料集名稱可接受具有兩個底線的名稱,但資料集的表格名稱只能包含單一底線。

一次可以執行多少個同時查詢?

回答
批次查詢作為後端作業執行時,沒有查詢並行限制。 但是,查詢逾時限制設為24小時。

是否有活動控制面板,讓您檢視查詢活動和狀態?

回答
有監視和警報功能可檢查查詢活動和狀態。 如需詳細資訊,請參閱查詢服務稽核記錄整合查詢記錄檔案。

是否有任何復原更新的方式? 例如,如果出現錯誤,或在將資料寫入Platform時某些計算需要重新設定,應如何處理該情況?

回答
目前,我們不支援以此方式復原或更新。

如何在Adobe Experience Platform中最佳化查詢?

回答

系統沒有索引,因為它不是資料庫,但它有繫結至資料存放區的其他最佳化。 下列選項可用來調整查詢:

  • 以時間系列資料為基礎的時間篩選器。
  • 已針對結構資料型別最佳化的向下推送。
  • 針對陣列和對應資料型別最佳化成本與記憶體下推式調整。
  • 使用快照的增量處理。
  • 持續存在的資料格式。

登入是否僅限於Query Service的某些方面,或是「完全或無」解決方案?

回答
查詢服務是「全有或無」的解決方案。 無法提供部分存取權。

我可以限制查詢服務可以使用的資料嗎?還是它只會存取整個Adobe Experience Platform資料湖?

回答
可以,您可以將查詢限制在具有唯讀存取權的資料集。

限制查詢服務可存取的資料有哪些其他選項?

回答

限制存取的方法有三種。 具體如下:

  • 使用SELECT陳述式並賦予資料集唯讀存取權。 此外,指派管理查詢許可權。
  • 使用SELECT/INSERT/CREATE陳述式,並賦予資料集寫入許可權。 此外,指派查詢管理許可權。
  • 使用具有上述建議的整合帳戶,並指派查詢整合許可權。

查詢服務傳回資料後,Platform是否可執行任何檢查,以確保其未傳回任何受保護的資料?

  • 查詢服務支援以屬性為基礎的存取控制。 您可以限制資料欄/分葉層級和/或結構層級的資料存取權。 請參閱檔案以進一步瞭解屬性型存取控制。

我可以指定連線至協力廠商使用者端的SSL模式嗎? 例如,我可以對Power BI使用「verify-full」嗎?

回答
是的,支援SSL模式。 請參閱SSL模式檔案,以取得可用不同SSL模式的劃分及其提供的保護等級。

我們是否針對所有從Power BI使用者端到查詢服務的連線使用TLS 1.2?

回答
是。 傳輸中的資料一律符合HTTPS規範。 目前支援的版本為TLS1.2。

在連線埠80上建立的連線是否仍使用https?

回答
是的,在連線埠80上建立的連線仍使用SSL。 您也可以使用連線埠5432。

我可以控制特定連線的特定資料集和欄的存取權嗎? 此設定方式?

回答
可以,若已設定,會強制實施以屬性為基礎的存取控制。 如需詳細資訊,請參閱以屬性為基礎的存取控制總覽

查詢服務是否支援「插入覆寫到」命令?

回答
否,查詢服務不支援「INSERT OVERWRITE INTO」命令。

授權使用量儀表板上的使用量資料多久更新一次,以符合Distiller計算時數的資料?

回答
Data Distiller電腦時數的授權使用儀表板每天更新四次,每六小時。

我可以在沒有Data Distiller存取權的情況下使用「建立檢視」命令嗎?

回答
是,您可以使用不具有Data Distiller存取權的CREATE VIEW命令。 此命令提供資料的邏輯檢視,但不會將其寫回資料湖。

我可以在DbVisualizer中使用匿名區塊嗎?

回答
是。 不過,某些協力廠商使用者端(例如DbVisualizer)在SQL區塊之前和之後可能需要個別的識別碼,以表示指令碼的部分應作為單一陳述式處理。 如需詳細資訊,請參閱匿名區塊檔案正式的DbVisualizer檔案

匯出資料 exporting-data

本節提供有關匯出資料和限制的資訊。

查詢處理後是否有從查詢服務擷取資料,並將結果儲存為CSV檔案? export-csv

回答

是。 資料可從查詢服務中擷取,也可選擇透過SQL命令將結果儲存為CSV格式。

使用PSQL使用者端時,有兩種方式可儲存查詢的結果。 您可以使用COPY TO命令,或使用下列格式建立陳述式:

code language-sql
SELECT column1, column2
FROM <table_name>
\g <table_name>.out

在SQL語法參考檔案中可找到COPY TO命令的使用指南。

我可以擷取透過CTAS查詢所擷取的最終資料集的內容嗎(假設這些資料量較大,例如TB)?

回答
不適用。 目前無法擷取已擷取的資料。

為何Analytics Data Connector沒有傳回資料?

回答

此問題的常見原因是查詢沒有時間篩選的時間序列資料。 例如:

code language-sql
SELECT * FROM prod_table LIMIT 1;

應該寫成:

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

協力廠商工具 third-party-tools

本節包含有關使用協力廠商工具(例如PSQL和Power BI)的資訊。

我可以將Query Service連線到協力廠商工具嗎?

回答
可以,您可以將多個協力廠商案頭使用者端連線至查詢服務。 請參閱檔案以取得有關可用使用者端以及如何將它們連線至查詢服務的完整詳細資料。

是否有方法可以連線一次查詢服務,以便與協力廠商工具繼續使用?

回答
可以,協力廠商案頭使用者端可透過一次性設定不會到期的憑證來連線至查詢服務。 未過期的認證可由授權的使用者產生,並透過自動下載至其本機電腦的JSON檔案接收。 在檔案中可找到有關如何建立和下載不會到期的認證🔗的完整指南。

為什麼我的不會到期的認證無法運作?

回答
不會到期的認證值是來自technicalAccountID的串連引數,以及來自組態JSON檔案的credential的串連引數。 密碼值的格式為: {{technicalAccountId}:{credential}}
請參閱檔案,以取得關於如何使用認證連線到外部使用者端的詳細資訊。

我可以連線到查詢服務編輯器的協力廠商SQL編輯器有哪一種?

回答
任何符合PSQL或Postgres使用者端規範的第三方SQL編輯器都可以連線至查詢服務編輯器。 如需可用指示的清單,請參閱將使用者端連線至查詢服務的檔案。

我可以將Power BI工具連線到查詢服務嗎?

回答
可以,您可以將Power BI連線至查詢服務。 請參閱檔案,以取得有關將Power BI案頭應用程式連線至查詢服務🔗的指示。

儀表板在連線至查詢服務時為何需要很長時間才能載入?

回答

當系統連線到查詢服務時,它會連線到互動式或批次處理引擎。 這可能會導致載入時間更長,以反映處理的資料。

如果您想要改善儀表板的回應時間,您應該實作Business Intelligence(BI)伺服器,作為Query Service和BI工具之間的快取層。 一般而言,大部分的BI工具都有額外的伺服器供應專案。

新增快取伺服器層的目的,是為了快取查詢服務的資料,並讓儀表板利用相同的快取伺服器層來加速回應。 這是可行的,因為執行的查詢結果每天都會在BI伺服器中快取。 快取伺服器接著會將這些結果提供給具有相同查詢的任何使用者,以減少延遲。 請參閱您所使用的公用程式或協力廠商工具的說明檔案,以進一步瞭解此設定。

是否可以使用pgAdmin連線工具存取查詢服務?

回答
否,不支援pgAdmin連線。 在檔案中可以找到可用協力廠商使用者端的清單,以及有關如何將它們連線至查詢服務的說明。

PostgreSQL API錯誤 postgresql-api-errors

下表提供PSQL錯誤碼及其可能的原因。

錯誤代碼
連線狀態
說明
可能的原因
08P01
不適用
不支援的訊息型別
不支援的訊息型別
28P01
啟動 — 驗證
密碼無效
無效的驗證Token
28000
啟動 — 驗證
無效的授權型別
無效的授權型別。 必須為AuthenticationCleartextPassword
42P12
啟動 — 驗證
找不到表格
找不到要使用的資料表
42601
查詢
語法錯誤
無效的命令或語法錯誤
42P01
查詢
找不到表格
找不到查詢中指定的資料表
42P07
查詢
表格已存在
已有相同名稱的表格存在(CREATE TABLE)
53400
查詢
LIMIT超過最大值
使用者指定的LIMIT子句高於100,000
53400
查詢
陳述式逾時
提交即時陳述式所花時間超過10分鐘上限
58000
查詢
系統錯誤
內部系統失敗
0A000
查詢/命令
不支援
不支援查詢/命令中的特性/功能
42501
刪除表格查詢
正在卸除不是由查詢服務建立的資料表
查詢服務不是使用CREATE TABLE陳述式來建立要卸除的資料表
42501
刪除表格查詢
資料表不是由已驗證的使用者建立
目前登入的使用者並未建立正在捨棄的表格
42P01
刪除表格查詢
找不到表格
找不到查詢中指定的資料表
42P12
刪除表格查詢
找不到dbName的資料表:請檢查dbName
在目前的資料庫中找不到資料表

為什麼我在表格上使用history_meta()方法時會收到58000錯誤碼?

回答

history_meta()方法用於從資料集存取快照。 先前,如果您要在Azure Data Lake Storage (ADLS)的空白資料集上執行查詢,您會收到一個58000的錯誤代碼,指出該資料集不存在。 舊系統錯誤的範例顯示如下。

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

發生此錯誤是因為查詢沒有傳回值。 此行為現在已修正,以傳回下列訊息:

code language-text
Query complete in {timeframe}. 0 rows returned.

REST API錯誤 rest-api-errors

下表提供HTTP錯誤代碼及其可能的原因。

HTTP狀態代碼
說明
可能的原因
400
錯誤的請求
查詢格式不正確或不合法
401
驗證失敗
無效的驗證權杖
500
內部伺服器錯誤
內部系統失敗
recommendation-more-help
ccf2b369-4031-483f-af63-a93b5ae5e3fb