以下是 Azure 記憶體擴充功能所提供的函式清單:
azure_storage.account_add
允許將記憶體帳戶及其相關聯的存取金鑰新增至擴充功能可以存取的記憶體帳戶 azure_storage 清單的函式。
如果先前叫用此函式已新增此記憶體帳戶的參考,則不會新增專案,而是更新現有專案的存取密鑰。
備註
此函式不會驗證參考帳戶名稱是否存在,或是否可使用提供的存取密鑰來存取。 不過,它會根據對 Azure 記憶體帳戶所強加的命名驗證規則,驗證記憶體帳戶的名稱是否有效。
azure_storage.account_add(account_name_p text, account_key_p text);
此函式有多載版本,可接受 account_config 封裝所參考 Azure 記憶體帳戶名稱的參數,以及驗證類型、帳戶類型或記憶體認證等所有必要的設定。
azure_storage.account_add(account_config jsonb);
權限
必須是的成員 azure_storage_admin。
論點
account_name_p
text 包含所有物件的 Azure Blob 記憶體帳戶名稱:Blob、檔案、佇列和數據表。 記憶體帳戶提供可從世界各地透過 HTTPS 存取的唯一命名空間。
account_key_p
text 儲存體帳戶的其中一個存取金鑰值。 您的 Azure Blob 記憶體存取金鑰類似於記憶體帳戶的根密碼。 請務必小心保護您的存取金鑰。 使用 Azure Key Vault,以安全的方式管理及輪替金鑰。 帳戶金鑰會儲存在只能由超級使用者存取的數據表中。 獲 azure_storage_admin 授與角色的用戶可透過函式與此數據表互動。 若要查看新增的記憶體帳戶,請使用 函式 azure_storage.account_list。
account_config
jsonb Azure 記憶體帳戶的名稱,以及驗證類型、帳戶類型或記憶體認證等所有必要的設定。 建議您使用公用程式函 式 azure_storage.account_options_managed_identity、 azure_storage.account_options_credentials 或 azure_storage.account_options 來建立任何必須傳遞為這個自變數的有效值。
傳回類型
VOID
azure_storage.account_options_managed_identity
做為公用程式函式的函式,可在 azure_storage.account_add 內呼叫為參數,並在使用系統指派的受控識別來與 Azure 儲存體帳戶互動時,產生自變數的有效值 account_config 很有用。
azure_storage.account_options_managed_identity(name text, type azure_storage.storage_type);
權限
任何使用者或角色都可以叫用此函式。
論點
名稱
text 包含所有物件的 Azure Blob 記憶體帳戶名稱:Blob、檔案、佇列和數據表。 記憶體帳戶提供可從世界各地透過 HTTPS 存取的唯一命名空間。
型別
azure_storage.storage_type 支援的其中一種記憶體類型值。 只有支援的值是 blob。
傳回類型
jsonb
azure_storage.account_options_credentials
做為公用程式函式的函式,可在 azure_storage.account_add 內呼叫為參數,而且在使用 Azure 記憶體存取密鑰與 Azure 記憶體帳戶互動時,產生自變數的有效值 account_config 很有用。
azure_storage.account_options_credentials(name text, credentials text, type azure_storage.storage_type);
權限
任何使用者或角色都可以叫用此函式。
論點
名稱
text 包含所有物件的 Azure Blob 記憶體帳戶名稱:Blob、檔案、佇列和數據表。 記憶體帳戶提供可從世界各地透過 HTTPS 存取的唯一命名空間。
憑證
text 儲存體帳戶的其中一個存取金鑰值。 您的 Azure Blob 記憶體存取金鑰類似於記憶體帳戶的根密碼。 請務必小心保護您的存取金鑰。 使用 Azure Key Vault,以安全的方式管理及輪替金鑰。 帳戶金鑰會儲存在只能由超級使用者存取的數據表中。 獲 azure_storage_admin 授與角色的用戶可透過函式與此數據表互動。 若要查看新增的記憶體帳戶,請使用 函式 azure_storage.account_list。
型別
azure_storage.storage_type 支援的其中一種記憶體類型值。 只有支援的值是 blob。
傳回類型
jsonb
azure_storage.account_options
做為公用程式函式的函式,可在 azure_storage.account_add 內呼叫為參數,而且在使用 Azure 記憶體存取密鑰或系統指派的受控識別來與 Azure 記憶體帳戶互動時,產生自變數的有效值 account_config 很有用。
azure_storage.account_options(name text, auth_type azure_storage.auth_type, storage_type azure_storage.storage_type, credentials text DEFAULT NULL);
權限
任何使用者或角色都可以叫用此函式。
論點
名稱
text 包含所有物件的 Azure Blob 記憶體帳戶名稱:Blob、檔案、佇列和數據表。 記憶體帳戶提供可從世界各地透過 HTTPS 存取的唯一命名空間。
auth_type
azure_storage.auth_type 支援的其中一種記憶體類型值。 只有支援的值是 access-key、 與 managed-identity。
storage_type
azure_storage.storage_type 支援的其中一種記憶體類型值。 只有支援的值是 blob。
憑證
text 儲存體帳戶的其中一個存取金鑰值。 您的 Azure Blob 記憶體存取金鑰類似於記憶體帳戶的根密碼。 請務必小心保護您的存取金鑰。 使用 Azure Key Vault,以安全的方式管理及輪替金鑰。 帳戶金鑰會儲存在只能由超級使用者存取的數據表中。 獲 azure_storage_admin 授與角色的用戶可透過函式與此數據表互動。 若要查看新增的記憶體帳戶,請使用 函式 azure_storage.account_list。
傳回類型
jsonb
azure_storage.account_remove
函式,允許從擴充功能可存取的記憶體帳戶清單中移除記憶體帳戶 azure_storage 及其相關聯的存取密鑰。
azure_storage.account_remove(account_name_p text);
權限
必須是的成員 azure_storage_admin。
論點
account_name_p
text 包含所有物件的 Azure Blob 記憶體帳戶名稱:Blob、檔案、佇列和數據表。 記憶體帳戶提供可從世界各地透過 HTTPS 存取的唯一命名空間。
傳回類型
VOID
azure_storage.account_user_add
允許透過延伸模組所提供的函式,授與PostgreSQL使用者或角色存取記憶體帳戶的 azure_storage 函式。
備註
只有在記憶體帳戶的名稱作為第一個自變數傳遞時,才會成功執行此函式,其名稱已使用 azure_storage.account_add 建立,而且如果使用者或角色的名稱傳遞為第二個自變數,則已經存在。
azure_storage.account_add(account_name_p text, user_p regrole);
權限
必須是的成員 azure_storage_admin。
論點
account_name_p
text 包含所有物件的 Azure Blob 記憶體帳戶名稱:Blob、檔案、佇列和數據表。 記憶體帳戶提供可從世界各地透過 HTTPS 存取的唯一命名空間。
user_p
regrole 伺服器上可用的PostgreSQL使用者或角色名稱。
傳回類型
VOID
azure_storage.account_user_remove
允許透過擴充功能所提供的函式,撤銷PostgreSQL使用者或角色存取記憶體帳戶的 azure_storage 函式。
備註
只有當名稱傳遞為第一個自變數的記憶體帳戶已使用 azure_storage.account_add 建立,而且名稱傳遞為第二個自變數的使用者或角色仍然存在時,此函式的執行才會成功。
當使用者或角色從伺服器卸除時,藉由執行 DROP USER | ROLE,也會自動排除對 Azure 儲存器帳戶的任何參考上授與的許可權。
azure_storage.account_user_remove(account_name_p text, user_p regrole);
權限
必須是的成員 azure_storage_admin。
論點
account_name_p
text 包含所有物件的 Azure Blob 記憶體帳戶名稱:Blob、檔案、佇列和數據表。 記憶體帳戶提供可從世界各地透過 HTTPS 存取的唯一命名空間。
user_p
regrole 伺服器上可用的PostgreSQL使用者或角色名稱。
傳回類型
VOID
azure_storage.account_list
函式會列出透過 azure_storage.account_add 函式所設定的記憶體帳戶名稱,以及授與許可權的 PostgreSQL 使用者或角色,透過擴充功能所提供的 azure_storage 函式與該記憶體帳戶互動。
azure_storage.account_list();
權限
必須是的成員 azure_storage_admin。
論點
此函式不會接受任何自變數。
傳回類型
TABLE(account_name text, auth_type azure_storage.auth_type, azure_storage_type azure_storage.storage_type, allowed_users regrole[]) 已新增 Azure 記憶體帳戶清單的四欄數據表、用來與每個帳戶互動的驗證類型、記憶體類型,以及授與其存取權的 PostgreSQL 使用者或角色清單。
azure_storage.blob_list
此函式會列出儲存在所參考記憶體帳戶指定容器中 Blob 的名稱和其他屬性(size、lastModified、eTag、contentType、contentEncoding 和 contentHash)。
azure_storage.blob_list(account_name text, container_name text, prefix text DEFAULT ''::text);
權限
叫用此函式的使用者或角色必須藉由執行 account_name,新增至所參考的允許清單。
azure_storage_admin的成員會自動允許參考使用 azure_storage.account_add 新增其參考的所有 Azure 儲存器帳戶。
論點
account_name
text 包含所有物件的 Azure Blob 記憶體帳戶名稱:Blob、檔案、佇列和數據表。 記憶體帳戶提供可從世界各地透過 HTTPS 存取的唯一命名空間。
容器名稱
text 容器的名稱。 容器會組織一組 Blob,類似於檔案系統中的目錄。 儲存體帳戶可以包括無限數量的容器,而一個容器則可儲存無限數量的 Blob。
容器名稱必須是有效的域名系統(DNS)名稱,因為它會形成用來尋址容器或其 Blob 的唯一 URI 的一部分。
命名容器時,請務必遵循 這些規則。
容器的 URI 類似於: https://myaccount.blob.core.windows.net/mycontainer
前綴
text 指定時,函式會傳回名稱開頭為此參數中提供值的 Blob。 預設為空字串。
傳回類型
TABLE(path text, bytes bigint, last_modified timestamp with time zone, etag text, content_type text, content_encoding text, content_hash text) 每個 Blob 傳回一筆記錄的數據表,包括 Blob 的完整名稱,以及一些其他屬性。
路徑
text Blob 的完整名稱。
位元組
bigint 以位元組為單位的 Blob 大小。
last_modified
timestamp with time zone上次修改 Blob 的日期和時間。 修改 Blob 的任何作業 (包括 Blob 更新的中繼資料或屬性),都會變更 Blob 上次修改的時間。
ETAG
text ETag 屬性用於更新期間的開放式並行存取。 它不是時間戳,因為有另一個稱為 Timestamp 的屬性會儲存上次更新記錄的時間。 例如,如果您載入實體並想要更新它,ETag 必須符合目前儲存的內容。 設定適當的 ETag 很重要,因為如果您有多個使用者編輯相同的專案,則不希望他們覆寫彼此的變更。
content_type
text 為 Blob 指定的內容類型。 預設內容型態為 application/octet-stream。
content_encoding
text Azure 記憶體可讓您定義之 Blob 的 Content-Encoding 屬性。 針對壓縮的內容,您可以將 屬性設定為 Gzip。 當瀏覽器存取內容時,它會自動解壓縮內容。
content_hash
text 用來驗證傳輸期間 Blob 完整性的哈希。 指定此標頭時,記憶體服務會使用從內容計算的哈希來檢查提供的哈希。 如果兩個哈希不匹配,則作將失敗,錯誤代碼為 400 (Bad Request)。
azure_storage.blob_get
允許匯入數據的函式。 它會從 Azure 記憶體帳戶中的 Blob 容器下載檔案。 然後,它會將內容轉譯成數據列,這些數據列可以使用SQL語言建構來取用和處理。 此函式新增了在匯入 Blob 容器之前篩選及作從 Blob 容器擷取的數據的支援。
備註
在嘗試存取所參考記憶體帳戶的容器之前,此函式會根據 Azure 記憶體帳戶所強加的命名驗證規則,檢查作為自變數傳遞的記憶體帳戶和容器名稱是否有效。 如果其中一個無效,就會引發錯誤。
azure_storage.blob_get(account_name text, container_name text, path text, decoder text DEFAULT 'auto'::text, compression text DEFAULT 'auto'::text, options jsonb DEFAULT NULL::jsonb);
此函式的多載版本可接受 rec 參數,可讓您方便定義輸出格式記錄。
azure_storage.blob_get(account_name text, container_name text, path text, rec anyelement, decoder text DEFAULT 'auto'::text, compression text DEFAULT 'auto'::text, options jsonb DEFAULT NULL::jsonb);
權限
叫用此函式的使用者或角色必須藉由執行 account_name,新增至所參考的允許清單。
azure_storage_admin的成員會自動允許參考使用 azure_storage.account_add 新增其參考的所有 Azure 儲存器帳戶。
論點
account_name
text 包含所有物件的 Azure Blob 記憶體帳戶名稱:Blob、檔案、佇列和數據表。 記憶體帳戶提供可從世界各地透過 HTTPS 存取的唯一命名空間。
容器名稱
text 容器的名稱。 容器會組織一組 Blob,類似於檔案系統中的目錄。 儲存體帳戶可以包括無限數量的容器,而一個容器則可儲存無限數量的 Blob。
容器名稱必須是有效的域名系統(DNS)名稱,因為它會形成用來尋址容器或其 Blob 的唯一 URI 的一部分。
命名容器時,請務必遵循 這些規則。
容器的 URI 類似於: https://myaccount.blob.core.windows.net/mycontainer
路徑
text Blob 的完整名稱。
娛樂
anyelement 記錄輸出結構的定義。
譯碼器
text Blob 格式的規格。 可以設定為下列任何值:
| 格式 | 預設值 | 說明 |
|---|---|---|
auto |
true |
根據指派給 Blob 名稱的最後一系列字元來推斷值。 如果 Blob 名稱以 結尾 .parquet,則會假設 parquet。 如果結尾為 .csv 或 .csv.gz,則會假設 csv。 如果結尾為 .tsv 或 .tsv.gz,則會假設 tsv。 如果結尾為 .json、.json.gz、、、.xml.xml.gz.txt、 或 .txt.gz, 則會假設text為 。 |
binary |
二進位 PostgreSQL COPY 格式。 | |
csv |
PostgreSQL COPY 所使用的逗號分隔值格式。 | |
parquet |
拼花式。 | |
text | xml | json |
包含單一文字值的檔案。 | |
tsv |
Tab 分隔值,預設 PostgreSQL COPY 格式。 |
壓縮
text 壓縮類型的規格。 可以設定為下列任何值:
| 格式 | 預設值 | 說明 |
|---|---|---|
auto |
true |
根據指派給 Blob 名稱的最後一系列字元來推斷值。 如果 Blob 名稱以 結尾 .gz,則會假設 gzip。 否則,它會假設 none。 |
brotli |
強制使用 brotli 壓縮演算法來壓縮 blob。 只有編碼器支援 parquet 。 |
|
gzip |
強制使用 gzip 壓縮演算法來壓縮 blob。 | |
lz4 |
強制使用 lz4 壓縮演算法來壓縮 blob。 只有編碼器支援 parquet 。 |
|
none |
有力避免壓縮膠塊。 | |
snappy |
強迫使用快速壓縮演算法來壓縮斑點。 只有編碼器支援 parquet 。 |
|
zstd |
強制使用 zstd 壓縮演算法來壓縮 blob。 只有編碼器支援 parquet 。 |
延伸模組不支援任何其他壓縮類型。
選項
jsonb 定義處理自訂標頭、自訂分隔符、逸出字元等的設定。 options 影響此函式的行為的方式,類似於您可以傳遞至 COPY PostgreSQL 中命令的選項如何影響其行為。
傳回類型
SETOF record
SETOF anyelement
azure_storage.blob_put
允許匯出數據的函式,方法是將檔案上傳至 Azure 記憶體帳戶中的 Blob 容器。 檔案的內容是從 PostgreSQL 中的數據列產生。
備註
在嘗試存取所參考記憶體帳戶的容器之前,此函式會根據 Azure 記憶體帳戶所強加的命名驗證規則,檢查作為自變數傳遞的記憶體帳戶和容器名稱是否有效。 如果其中一個無效,就會引發錯誤。
azure_storage.blob_put(account_name text, container_name text, path text, tuple record)
RETURNS VOID;
函式有多載版本,其中包含 encoder 參數,可讓您指定編碼器在無法從參數的 path 延伸模組推斷時使用,或當您想要覆寫推斷的編碼器時使用。
azure_storage.blob_put(account_name text, container_name text, path text, tuple record, encoder text)
RETURNS VOID;
函式的多載版本也包含 compression 參數,可讓您指定要在無法從參數延伸 path 模組推斷壓縮時使用,或當您想要覆寫推斷的壓縮時使用。
azure_storage.blob_put(account_name text, container_name text, path text, tuple record, encoder text, compression text)
RETURNS VOID;
函式的多載版本也包含 options 用來處理自定義標頭、自定義分隔符、逸出字元等的參數, options 其運作方式與可在 PostgreSQL 中傳遞至 COPY 命令的選項類似。
azure_storage.blob_put(account_name text, container_name text, path text, tuple record, encoder text, compression text, options jsonb)
RETURNS VOID;
權限
叫用此函式的使用者或角色必須藉由執行 account_name,新增至所參考的允許清單。
azure_storage_admin的成員會自動允許參考使用 azure_storage.account_add 新增其參考的所有 Azure 儲存器帳戶。
論點
account_name
text 包含所有物件的 Azure Blob 記憶體帳戶名稱:Blob、檔案、佇列和數據表。 記憶體帳戶提供可從世界各地透過 HTTPS 存取的唯一命名空間。
容器名稱
text 容器的名稱。 容器會組織一組 Blob,類似於檔案系統中的目錄。 儲存體帳戶可以包括無限數量的容器,而一個容器則可儲存無限數量的 Blob。
容器名稱必須是有效的域名系統(DNS)名稱,因為它會形成用來尋址容器或其 Blob 的唯一 URI 的一部分。
命名容器時,請務必遵循 這些規則。
容器的 URI 類似於: https://myaccount.blob.core.windows.net/mycontainer
路徑
text Blob 的完整名稱。
Tuple
record 記錄輸出結構的定義。
編碼器
text Blob 格式的規格。 可以設定為下列任何值:
| 格式 | 預設值 | 說明 |
|---|---|---|
auto |
true |
根據指派給 Blob 名稱的最後一系列字元來推斷值。 如果 Blob 名稱結尾為 .csv 或 .csv.gz,則會假設 csv為 。 如果結尾為 .tsv 或 .tsv.gz,則會假設 tsv。 如果結尾為 .json、.json.gz、、、.xml.xml.gz.txt、 或 .txt.gz, 則會假設text為 。 |
binary |
二進位 PostgreSQL COPY 格式。 | |
csv |
PostgreSQL COPY 所使用的逗號分隔值格式。 | |
parquet |
拼花式。 | |
text | xml | json |
包含單一文字值的檔案。 | |
tsv |
Tab 分隔值,預設 PostgreSQL COPY 格式。 |
壓縮
text 壓縮類型的規格。 可以設定為下列任何值:
| 格式 | 預設值 | 說明 |
|---|---|---|
auto |
true |
根據指派給 Blob 名稱的最後一系列字元來推斷值。 如果 Blob 名稱以 結尾 .gz,則會假設 gzip。 否則,它會假設 none。 |
brotli |
強制使用 brotli 壓縮演算法來壓縮 blob。 只有編碼器支援 parquet 。 |
|
gzip |
強制使用 gzip 壓縮演算法來壓縮 blob。 | |
lz4 |
強制使用 lz4 壓縮演算法來壓縮 blob。 只有編碼器支援 parquet 。 |
|
none |
有力避免壓縮膠塊。 | |
snappy |
強迫使用快速壓縮演算法來壓縮斑點。 只有編碼器支援 parquet 。 |
|
zstd |
強制使用 zstd 壓縮演算法來壓縮 blob。 只有編碼器支援 parquet 。 |
延伸模組不支援任何其他壓縮類型。
選項
jsonb 定義處理自訂標頭、自訂分隔符、逸出字元等的設定。 options 影響此函式的行為的方式,類似於您可以傳遞至 COPY PostgreSQL 中命令的選項如何影響其行為。
傳回類型
VOID
azure_storage.options_copy
做為公用程式函式的函式,它可以在 內 blob_get呼叫為參數。 它作為 options_parquet、 options_csv_get、 options_tsv和 options_binary的輔助功能。
azure_storage.options_copy(delimiter text DEFAULT NULL::text, null_string text DEFAULT NULL::text, header boolean DEFAULT NULL::boolean, quote text DEFAULT NULL::text, escape text DEFAULT NULL::text, force_quote text[] DEFAULT NULL::text[], force_not_null text[] DEFAULT NULL::text[], force_null text[] DEFAULT NULL::text[], content_encoding text DEFAULT NULL::text);
權限
任何使用者或角色都可以叫用此函式。
論點
分隔符號
text 分隔檔案中每個數據列(行)內之數據行的字元。 它必須是單一 1 位元組字元。 雖然此函式支援任意數目字元的分隔符,但如果您嘗試使用多個 1 位元組字元,PostgreSQL 會回報錯誤 COPY delimiter must be a single one-byte character 。
null_string
text 表示 Null 值的字串。 預設值為文字格式的 \N (反斜杠-N),並以 CSV 格式加上未標記的空字串。 即使您不想區分 Null 與空字串的情況,您仍可能偏好使用文字格式的空字串。
標頭
boolean 旗標,指出檔案是否包含標題行,其中包含檔案中每個數據行的名稱。 在輸出中,初始行包含數據表中的數據行名稱。
報價
text 引用數據值時所要使用的引號字元。 預設值為雙引號。 它必須是單一 1 位元組字元。 雖然此函式支援任意數目字元的分隔符,但如果您嘗試使用多個 1 位元組字元,PostgreSQL 會回報錯誤 COPY quote must be a single one-byte character 。
逃
text 應該出現在符合 QUOTE 值之數據字元之前的字元。 默認值與 QUOTE 值相同(因此,如果引號字元出現在數據中,則會加倍)。 它必須是單一 1 位元組字元。 雖然此函式支援任意數目字元的分隔符,但如果您嘗試使用多個 1 位元組字元,PostgreSQL 會回報錯誤 COPY escape must be a single one-byte character 。
force_quote
text[] 會強制用於每個指定數據行中所有非 NULL 值的引號。 NULL 輸出絕不會加上引號。 如果指定 * ,則所有資料行都會加上非 NULL 值引號。
force_not_null
text[] 不符合指定的數據行值與 Null 字串。 在 Null 字串是空的預設值中,這表示空值會讀取為零長度字串,而不是 Null,即使未加上引號也一樣。
force_null
text[] 比對指定的數據行值與 Null 字串相符,即使加上引號,如果找到相符專案,請將值設定為 NULL。 在 Null 字串是空的預設值中,它會將引號空字串轉換成 NULL。
content_encoding
text 編碼所使用之檔案的名稱。 如果省略選項,則會使用目前的用戶端編碼。
傳回類型
jsonb
azure_storage.options_parquet
作為一個效用函數,可作為參數 blob_get在 中呼叫,且有助於解碼 parquet 檔案的內容。
azure_storage.options_parquet();
權限
任何使用者或角色都可以叫用此函式。
論點
傳回類型
jsonb
azure_storage.options_csv_get
做為公用程式函式的函式,可在 內 blob_get呼叫做為參數,而且有助於譯碼 csv 檔案的內容。
azure_storage.options_csv_get(delimiter text DEFAULT NULL::text, null_string text DEFAULT NULL::text, header boolean DEFAULT NULL::boolean, quote text DEFAULT NULL::text, escape text DEFAULT NULL::text, force_not_null text[] DEFAULT NULL::text[], force_null text[] DEFAULT NULL::text[], content_encoding text DEFAULT NULL::text);
權限
任何使用者或角色都可以叫用此函式。
論點
分隔符號
text 分隔檔案中每個數據列(行)內之數據行的字元。 它必須是單一 1 位元組字元。 雖然此函式支援任意數目字元的分隔符,但如果您嘗試使用多個 1 位元組字元,PostgreSQL 會回報錯誤 COPY delimiter must be a single one-byte character 。
null_string
text 表示 Null 值的字串。 預設值為文字格式的 \N (反斜杠-N),並以 CSV 格式加上未標記的空字串。 即使您不想區分 Null 與空字串的情況,您仍可能偏好使用文字格式的空字串。
標頭
boolean 旗標,指出檔案是否包含標題行,其中包含檔案中每個數據行的名稱。 在輸出中,初始行包含數據表中的數據行名稱。
報價
text 引用數據值時所要使用的引號字元。 預設值為雙引號。 它必須是單一 1 位元組字元。 雖然此函式支援任意數目字元的分隔符,但如果您嘗試使用多個 1 位元組字元,PostgreSQL 會回報錯誤 COPY quote must be a single one-byte character 。
逃
text 應該出現在符合 QUOTE 值之數據字元之前的字元。 默認值與 QUOTE 值相同(因此,如果引號字元出現在數據中,則會加倍)。 它必須是單一 1 位元組字元。 雖然此函式支援任意數目字元的分隔符,但如果您嘗試使用多個 1 位元組字元,PostgreSQL 會回報錯誤 COPY escape must be a single one-byte character 。
force_not_null
text[] 不符合指定的數據行值與 Null 字串。 在 Null 字串是空的預設值中,這表示空值會讀取為零長度字串,而不是 Null,即使未加上引號也一樣。
force_null
text[] 比對指定的數據行值與 Null 字串相符,即使加上引號,如果找到相符專案,請將值設定為 NULL。 在 Null 字串是空的預設值中,它會將引號空字串轉換成 NULL。
content_encoding
text 編碼所使用之檔案的名稱。 如果省略選項,則會使用目前的用戶端編碼。
傳回類型
jsonb
azure_storage.options_tsv
做為公用程式函式的函式,可在 內 blob_get呼叫做為參數,而且適用於譯碼 tsv 檔案的內容。
azure_storage.options_tsv(delimiter text DEFAULT NULL::text, null_string text DEFAULT NULL::text, content_encoding text DEFAULT NULL::text);
權限
任何使用者或角色都可以叫用此函式。
論點
分隔符號
text 分隔檔案中每個數據列(行)內之數據行的字元。 它必須是單一 1 位元組字元。 雖然此函式支援任意數目字元的分隔符,但如果您嘗試使用多個 1 位元組字元,PostgreSQL 會回報錯誤 COPY delimiter must be a single one-byte character 。
null_string
text 表示 Null 值的字串。 預設值為文字格式的 \N (反斜杠-N),並以 CSV 格式加上未標記的空字串。 即使您不想區分 Null 與空字串的情況,您仍可能偏好使用文字格式的空字串。
content_encoding
text 編碼所使用之檔案的名稱。 如果省略選項,則會使用目前的用戶端編碼。
傳回類型
jsonb
azure_storage.options_binary
做為公用程式函式的函式,可在 內 blob_get呼叫做為參數,而且對於譯碼二進位檔的內容很有用。
azure_storage.options_binary(content_encoding text DEFAULT NULL::text);
權限
任何使用者或角色都可以叫用此函式。
論點
content_encoding
text 編碼所使用之檔案的名稱。 如果省略選項,則會使用目前的用戶端編碼。
傳回類型
jsonb