選取您的 Cookie 偏好設定

我們使用提供自身網站和服務所需的基本 Cookie 和類似工具。我們使用效能 Cookie 收集匿名統計資料,以便了解客戶如何使用我們的網站並進行改進。基本 Cookie 無法停用,但可以按一下「自訂」或「拒絕」以拒絕效能 Cookie。

如果您同意,AWS 與經核准的第三方也會使用 Cookie 提供實用的網站功能、記住您的偏好設定,並顯示相關內容,包括相關廣告。若要接受或拒絕所有非必要 Cookie,請按一下「接受」或「拒絕」。若要進行更詳細的選擇,請按一下「自訂」。

進階選項

焦點模式
進階選項 - Amazon Athena

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

擷取大小

本次請求傳回結果 (列) 的最大數量。如需參數資訊,請參閱 GetQuery MaxResults。對於串流 API,最大值為 10000000。

連線字串名稱 參數類型 預設值 連線字串範例
RowsToFetchPerBlock 選用

非串流為 1000

串流為 20000

RowsToFetchPerBlock=20000;

啟用結果重複使用

指定執行查詢時是否可以重複使用之前的查詢結果。如需參數資訊,請參閱 ResultReuseByAgeConfiguration。

連線字串名稱 參數類型 預設值 連線字串範例
EnableResultReuse 選用 0 EnableResultReuse=1;

結果重複使用最長期限

指定 Athena 應考慮重複使用的之前查詢結果的最長期限 (以分鐘為單位)。如需參數資訊,請參閱 ResultReuseByAgeConfiguration

連線字串名稱 參數類型 預設值 連線字串範例
ReusedResultMaxAgeInMinutes 選用 60 ReusedResultMaxAgeInMinutes=90;

啟用串流 API

選擇是否使用 Athena 串流 API 來擷取結果集。

連線字串名稱 參數類型 預設值 連線字串範例
UseResultsetStreaming 選用 0 UseResultsetStreaming=1;

啟用 S3 擷取程式

直接與 Amazon S3 互動,從 Amazon S3 儲存貯體擷取 Athena 產生的結果集。

連線字串名稱 參數類型 預設值 連線字串範例
EnableS3Fetcher 選用 1 EnableS3Fetcher=1;

使用多個 S3 執行緒

使用多個執行緒從 Amazon S3 擷取資料。啟用此選項時,會使用多個執行緒平行擷取存放在 Amazon S3 儲存貯體中的結果檔案。

只有在網路頻寬良好時,才會啟用此選項。例如,在我們對 EC2 c5.2xlarge 執行個體的測量中,單一執行緒 S3 用戶端達到 1 Gbps,而多執行緒 S3 用戶端則達到 4 Gbps 的網路輸送量。

連線字串名稱 參數類型 預設值 連線字串範例

UseMultipleS3Threads

選用 0 UseMultipleS3Threads=1;

使用單一目錄和結構描述

依預設,ODBC 驅動程式會查詢 Athena,以取得可用目錄和結構描述的清單。此選項會強制驅動程式使用「ODBC 資料來源管理員組態」對話方塊或連線參數指定的目錄和結構描述。

連線字串名稱 參數類型 預設值 連線字串範例
UseSingleCatalogAndSchema 選用 0 UseSingleCatalogAndSchema=1;

使用查詢列出資料表

對於LAMBDA目錄類型, 可讓 ODBC 驅動程式提交SHOW TABLES查詢,以取得可用資料表的清單。此設定是預設值。如果此參數設為 0,ODBC 驅動程式會使用 Athena ListTableMetadata API 來取得可用資料表的清單。請注意,對於LAMBDA目錄類型,使用 ListTableMetadata 會導致效能迴歸。

連線字串名稱 參數類型 預設值 連線字串範例
UseQueryToListTables 選用 1 UseQueryToListTables=1;

針對字串類型使用 WCHAR

預設情況下,ODBC 驅動程式SQL_VARCHAR會對 Athena 使用 SQL_CHAR和 字串資料類型 charvarcharstringarraymap<> struct<>row。將此參數設定為1強制驅動程式SQL_WVARCHAR針對字串資料類型使用 SQL_WCHAR和 。寬字元和寬變數字元類型用於確保來自不同語言的字元可以正確存放和擷取。

連線字串名稱 參數類型 預設值 連線字串範例
UseWCharForStringTypes 選用 0 UseWCharForStringTypes=1;

查詢外部目錄

指定驅動程式是否需要從 Athena 查詢外部目錄。如需詳細資訊,請參閱遷移至 ODBC 2.x 驅動程式

連線字串名稱 參數類型 預設值 連線字串範例
QueryExternalCatalogs 選用 0 QueryExternalCatalogs=1;

驗證 SSL

控制是否在使用 AWS SDK 時驗證 SSL 憑證。這個值會傳遞給 ClientConfiguration.verifySSL 參數。如需詳細資訊,請參閱《適用於 C++ 的 AWS SDK 開發人員指南》中的 AWS 用戶端組態

連線字串名稱 參數類型 預設值 連線字串範例
VerifySSL 選用 1 VerifySSL=0;

S3 結果區塊大小

指定單一 Amazon S3 GetObject API 請求下載的區塊大小 (以位元組為單位)。預設值為 67108864 (64 MB)。允許的最小值和最大值為 10485760 (10 MB) 和 2146435072 (約 2 GB)。

連線字串名稱 參數類型 預設值 連線字串範例
S3ResultBlockSize 選用 67108864 S3ResultBlockSize=268435456;

字串欄長度

指定具有 string資料類型之資料欄的資料欄長度。由於 Athena 使用 Apache Hive 字串資料類型,而此類型沒有定義的精確度,因此 Athena 報告的預設長度為 2147483647 (INT_MAX)。由於 BI 工具通常預先配置資料欄的記憶體,這可能會導致高記憶體耗用。為了避免這種情況,Athena ODBC 驅動程式會限制string報告的資料類型資料欄精確度,並公開StringColumnLength連線參數,以便可以變更預設值。

連線字串名稱 參數類型 預設值 連線字串範例
StringColumnLength 選用 255 StringColumnLength=65535;

複雜類型資料欄長度

指定具有複雜資料類型的資料欄長度map,例如 struct、 和 array。如同 StringColumnLength,Athena 會針對具有複雜資料類型的資料欄報告 0 個精確度。Athena ODBC 驅動程式會為具有複雜資料類型的資料欄設定預設精確度,並公開ComplexTypeColumnLength連線參數,以便變更預設值。

連線字串名稱 參數類型 預設值 連線字串範例
ComplexTypeColumnLength 選用 65535 ComplexTypeColumnLength=123456;

可信 CA 憑證

指示 HTTP 用戶端在何處找到您的 SSL 憑證信任存放區。這個值會傳遞給 ClientConfiguration.caFile 參數。如需詳細資訊,請參閱《適用於 C++ 的 AWS SDK 開發人員指南》中的 AWS 用戶端組態

連線字串名稱 參數類型 預設值 連線字串範例
TrustedCerts 選用 %INSTALL_PATH%/bin TrustedCerts=C:\\Program Files\\Amazon Athena ODBC Driver\\bin\\cacert.pem;

最短輪詢期間

指定輪詢 Athena 查詢執行狀態之前要等待的最小值 (以毫秒為單位)。

連線字串名稱 參數類型 預設值 連線字串範例
MinQueryExecutionPollingInterval 選用 100 MinQueryExecutionPollingInterval=200;

最長輪詢期間

指定輪詢 Athena 查詢執行狀態之前要等待的最大值 (以毫秒為單位)。

連線字串名稱 參數類型 預設值 連線字串範例
MaxQueryExecutionPollingInterval 選用 60000 MaxQueryExecutionPollingInterval=1000;

輪詢乘數

指定增加輪詢期間的因數。依預設,輪詢會以最短輪詢期間的值開始,並且每次輪詢都會加倍,直到達到最長輪詢期間的值為止。

連線字串名稱 參數類型 預設值 連線字串範例
QueryExecutionPollingIntervalMultiplier 選用 2 QueryExecutionPollingIntervalMultiplier=2;

最長輪詢持續時間

指定驅動程式可輪詢 Athena 查詢執行狀態的最大值 (以毫秒為單位)。

連線字串名稱 參數類型 預設值 連線字串範例
MaxPollDuration 選用 1800000 MaxPollDuration=1800000;

連線逾時

HTTP 連線等待建立連線的時間量 (以毫秒為單位)。此值是針對 ClientConfiguration.connectTimeoutMs Athena 用戶端設定的。若未指定,則使用 curl 預設值。如需有關連線參數的資訊,請參閱《適用於 Java 的 AWS SDK 開發人員指南》中的用戶端組態

連線字串名稱 參數類型 預設值 連線字串範例
ConnectionTimeout 選用 0 ConnectionTimeout=2000;

請求逾時

指定 HTTP 用戶端的通訊端讀取逾時。此值是為 Athena 用戶端的 ClientConfiguration.requestTimeoutMs 參數設定的。如需參數資訊,請參閱《適用於 Java 的 AWS SDK 開發人員指南》中的用戶端組態

連線字串名稱 參數類型 預設值 連線字串範例
RequestTimeout 選用 10000 RequestTimeout=30000;

下一個主題:

代理

上一個主題:

端點
隱私權網站條款Cookie 偏好設定
© 2025, Amazon Web Services, Inc.或其附屬公司。保留所有權利。