Void

Lấy ước tính kích thước quan hệ cho một bảng nước kèo bóng đá c1. Điều này được gọi là khi bắt đầu lập kế hoạch cho một truy vấn quét một bàn nước kèo bóng đá c1.rootlà thông tin toàn cầu kèo bóng đá c1 người lập kế hoạch về truy vấn;Baserellà thông tin kèo bóng đá c1 người lập kế hoạch về bảng này; VàForeignTableIDlàpg_ classOID của Bàn nước kèo bóng đá c1. (ForeignTableIDcó thể được lấy từ kèo bóng đá c1 cấu trúc dữ liệu kế hoạch, nhưng nó được truyền rõ ràng để tiết kiệm nỗ lực.)

Hàm này sẽ cập nhậtbaserel- hàngLà số lượng hàng dự kiến ​​được trả lại bằng cách quét bảng, sau khi tính toán cho việc lọc được thực hiện bởi kèo bóng đá c1 câu hỏi hạn chế. Giá trị ban đầu củabaserel- hàngchỉ là ước tính mặc định không đổi, cần được thay thế nếu có thể. Chức năng cũng có thể chọn cập nhậtBaserel- WidthNếu nó có thể tính toán ước tính tốt hơn về chiều rộng hàng kết quả trung bình. .Phân tích.) kèo bóng đá c1 ra, chức năng này có thể cập nhậtBaserel- TuplesNếu nó có thể tính toán ước tính tốt hơn về tổng số hàng của Bàn nước kèo bóng đá c1. (Giá trị ban đầu là từpg_ class.Reltuplesđại diện cho tổng số hàng được nhìn thấy bởi lần cuốiPhân tích.)

xemPhần 57.4Để biết thêm thông tin.

VOID

Tạo kèo bóng đá c1 đường dẫn truy cập có thể để quét trên bàn nước ngoài. Điều này được gọi trong quá trình lập kế hoạch truy vấn.getforeignrelsize, đã được kèo bóng đá c1.

Hàm này phải tạo ít nhất một đường dẫn truy cập (ForeignPathnút) để quét trên bàn nước kèo bóng đá c1 và phải gọiadd_pathĐể thêm mỗi đường dẫn như vậy vàoBaserel- Pathlist. Nó được khuyến nghị sử dụngcreated_forignscan_pathĐể xây dựngForeignPathnút. Hàm có thể tạo nhiều đường dẫn truy cập, ví dụ: đường dẫn có hợp lệPathkeysĐể thể hiện kết quả được sắp xếp trước. Mỗi đường dẫn truy cập phải chứa kèo bóng đá c1 ước tính chi phí và có thể chứa bất kỳ thông tin đặc biệt nào cần thiết để xác định phương thức quét cụ thể dự định.

xemPhần 57.4Để biết thêm thông tin.

nước kèo bóng đá c1 *

Tạo AForeignScanKế hoạch nút từ đường dẫn truy cập nước kèo bóng đá c1 đã chọn. Điều này được gọi vào cuối kế hoạch truy vấn.getforeignrelsize, cộng với đã chọnForeignPath(trước đây được sản xuất bởiGetforignPaths, getforeignjoinpathshoặcGetforeignuppPaths), Danh sách mục tiêu được phát ra bởi nút kế hoạch, kèo bóng đá c1 điều khoản hạn chế được thực thi bởi nút kế hoạch và kế hoạch con bên ngoài củaForeignScan, được sử dụng để kiểm tra lại được thực hiện bởiRecheckForignScan. (Nếu đường dẫn dành cho tham gia chứ không phải là mối quan hệ cơ sở,ForeignTableIDlàkhông hợp lệ.)

Hàm này phải tạo và trả về AForeignScanKế hoạch nút; nó được khuyến nghị sử dụngmake_forignscanĐể xây dựngForeignScanNode.

xemPhần 57.4Để biết thêm thông tin.

Void

Bắt đầu thực hiện quét nước kèo bóng đá c1. Điều này được gọi trong quá trình khởi động thực thi.itaterforignscan). TheForeignScanStateNode đã được tạo, nhưngfdw_stateTrường vẫn còn vô hiệu. Thông tin về bảng để quét có thể truy cập được thông quanước kèo bóng đá c1nút (đặc biệt, từ bên dướiForeignScanKế hoạch nút, chứa bất kỳ thông tin FDW-Private nào được cung cấp bởigetforignplan).EFLAGSChứa kèo bóng đá c1 bit cờ mô tả chế độ hoạt động của người thực thi cho nút kế hoạch này.

Lưu ý rằng khi(eflags & exec_flag_explain_only)là đúng, chức năng này không nên thực hiện bất kỳ hành động nào có thể nhìn nhận được; nó chỉ nên làm tối thiểu cần thiết để làm cho trạng thái nút hợp lệ choGiải thích FormentIgnScanvàendforeignscan.

tupletableslot *

Lấy một hàng từ nguồn nước kèo bóng đá c1, trả lại trong một khe cắm bảng Tuple (nút của nútscantuplotlotnên được sử dụng cho mục đích này). Trả lại null nếu không có nhiều hàng có sẵn.BeginForignScanNếu bạn cần lưu trữ tồn tại lâu hơn hoặc sử dụngES_Query_CXTkèo bóng đá c1 nútEstate.

kèo bóng đá c1 hàng được trả về phải khớp vớifdw_scan_tlistDanh sách mục tiêu Nếu được cung cấp, nếu không, chúng phải khớp với loại hàng của bảng nước ngoài được quét. Nếu bạn chọn tối ưu hóa kèo bóng đá c1 cột tìm nạp không cần thiết, bạn nên chèn kèo bóng đá c1 null vào kèo bóng đá c1 vị trí cột đó, hoặc nếu không sẽ tạo raFDW_SCAN_TLISTDanh sách với kèo bóng đá c1 cột bị bỏ qua.

Lưu ý rằngPostgreSQLNgười thực thi không quan tâm liệu kèo bóng đá c1 hàng có trả lại vi phạm bất kỳ ràng buộc nào được xác định trên Bàn nước ngoài hay không - nhưng người lập kế hoạch có quan tâm và có thể tối ưu hóa kèo bóng đá c1 truy vấn không chính xác nếu có kèo bóng đá c1 hàng có thể nhìn thấy trong bảng nước ngoài không thỏa mãn ràng buộc. Nếu một ràng buộc bị vi phạm khi người dùng đã tuyên bố rằng ràng buộc sẽ đúng, có thể phù hợp để gây ra lỗi (giống như bạn cần phải làm trong trường hợp không khớp loại dữ liệu).

Void

Khởi động lại quá trình quét từ đầu. Lưu ý rằng bất kỳ tham số nào mà quét phụ thuộc vào có thể đã thay đổi giá trị, do đó quét mới không nhất thiết phải trả về chính xác cùng một hàng.

Void

Kết thúc tài nguyên quét và phát hành. Thông thường không quan trọng để phát hành bộ nhớ palloc'd, nhưng ví dụ: mở kèo bóng đá c1 tệp và kết nối với kèo bóng đá c1 máy chủ từ xa nên được làm sạch.

Nếu FDW hỗ trợ thực hiện kèo bóng đá c1 tham gia nước ngoài từ xa (thay vì tìm nạp dữ liệu của cả hai bảng và thực hiện tham gia cục bộ), nó sẽ cung cấp chức năng gọi lại này:

Void

Tạo kèo bóng đá c1 đường dẫn truy cập có thể cho sự tham gia của hai (hoặc nhiều) bảng nước ngoài mà tất cả đều thuộc về cùng một máy chủ nước ngoài. Chức năng tùy chọn này được gọi trong quá trình lập kế hoạch truy vấn.GetforignPaths, Hàm này sẽ tạoForeignPathĐường dẫn cho được cung cấptham giavà kèo bóng đá c1add_pathĐể thêm kèo bóng đá c1 đường dẫn này vào tập hợp kèo bóng đá c1 đường dẫn được xem xét cho sự tham gia. Nhưng không giống nhưGetforeignPaths, Không cần thiết phải thành công trong việc tạo ít nhất một đường dẫn, vì kèo bóng đá c1 đường dẫn liên quan đến việc tham gia cục bộ luôn luôn có thể.

Lưu ý rằng chức năng này sẽ được gọi nhiều lần cho cùng một mối quan hệ tham gia, với kèo bóng đá c1 kết hợp khác nhau của quan hệ bên trong và bên ngoài; Trách nhiệm của FDW là giảm thiểu công việc trùng lặp.

Nếu AForeignPathĐường dẫn được chọn cho tham gia, nó sẽ đại diện cho toàn bộ quá trình tham gia; kèo bóng đá c1 đường dẫn được tạo cho kèo bóng đá c1 bảng thành phần và kèo bóng đá c1 công ty con sẽ không được sử dụng.ScanRelidkèo bóng đá c1 kết quảnước kèo bóng đá c1Kế hoạch Nên được đặt thành 0, vì không có mối quan hệ nào mà nó đại diện; Thay vào đó,FS_RELIDSTrường kèo bóng đá c1ForeignScanNode đại diện cho tập hợp kèo bóng đá c1 mối quan hệ đã được nối. .fdw_scan_tlistVới danh sách thích hợpTargetEntrykèo bóng đá c1 nút, đại diện cho tập hợp kèo bóng đá c1 cột nó sẽ cung cấp trong thời gian chạy trong kèo bóng đá c1 bộ dữ liệu mà nó trả về.

xemPhần 57.4Để biết thêm thông tin.

Nếu FDW hỗ trợ thực hiện xử lý sau khi quét/tham gia từ xa, chẳng hạn như tập hợp từ xa, nó sẽ cung cấp chức năng kèo bóng đá c1 lại này:

VOID

Tạo đường dẫn truy cập có thể choMối quan hệ trênXử lý, là thuật ngữ của người lập kế hoạch cho tất cả kèo bóng đá c1 truy vấn sau khi quét/tham gia, chẳng hạn như tập hợp, chức năng cửa sổ, sắp xếp và cập nhật bảng. Chức năng tùy chọn này được gọi trong quá trình lập kế hoạch truy vấn.ForeignPathĐường dẫn cho bất kỳ xử lý sau khi quét/tham gia mà FDW biết cách thực hiện từ xa và kèo bóng đá c1add_pathĐể thêm kèo bóng đá c1 đường dẫn này vào quan hệ trên được chỉ định. Như vớigetforeignjoinpaths, Không cần thiết phải thành công trong việc tạo ra bất kỳ đường dẫn nào, vì kèo bóng đá c1 đường dẫn liên quan đến xử lý cục bộ luôn luôn có thể.

TheGiai đoạntham số xác định bước sau khi quét/tham gia hiện đang được xem xét.output_rellà mối quan hệ trên sẽ nhận kèo bóng đá c1 đường dẫn đại diện cho tính toán của bước này vàinput_rellà mối quan hệ đại diện cho đầu vào cho bước này. TheExtraTham số cung cấp chi tiết bổ sung, hiện tại, nó chỉ được đặt choupperrel_partial_group_agghoặcupperrel_group_agg, trong trường hợp đó nó chỉ vào AGROUPPATHEXTRADATACấu trúc. (Lưu ý rằngForeignPathđường dẫn được thêm vàooutput_relThông thường sẽ không có bất kỳ sự phụ thuộc trực tiếp nào vào kèo bóng đá c1 đường dẫn củainput_rel, vì việc xử lý của họ dự kiến ​​sẽ được thực hiện bên ngoài. Tuy nhiên, việc kiểm tra kèo bóng đá c1 đường dẫn được tạo trước đó cho bước xử lý trước đó có thể hữu ích để tránh công việc lập kế hoạch dự phòng.)

xemPhần 57.4Để biết thêm thông tin.

Nếu FDW hỗ trợ kèo bóng đá c1 bảng nước ngoài có thể ghi, nó sẽ cung cấp một số hoặc tất cả kèo bóng đá c1 chức năng gọi lại sau đây tùy thuộc vào nhu cầu và khả năng của FDW:

Void

Cập nhậtvàXóaHoạt động được thực hiện đối với kèo bóng đá c1 hàng trước đó được tìm nạp trước kèo bóng đá c1 chức năng quét bảng. FDW có thể cần thêm thông tin, chẳng hạn như ID hàng hoặc kèo bóng đá c1 giá trị của kèo bóng đá c1 cột khóa chính, để đảm bảo rằng nó có thể xác định hàng chính xác để cập nhật hoặc xóa.Hồirác, kèo bóng đá c1 cột mục tiêu vào danh sách kèo bóng đá c1 cột sẽ được lấy từ Bàn nước ngoài trong mộtCập nhậthoặcXóa.

Để làm điều đó, thêmTargetEntryMục tớiParsetree- TargetList, chứa kèo bóng đá c1 biểu thức cho kèo bóng đá c1 giá trị bổ sung được tìm nạp. Mỗi mục nhập như vậy phải được đánh dấuresjunk=TRUE, và phải có một sự khác biệtResNamesẽ xác định nó vào thời điểm thực hiện. Tránh sử dụng tên khớpCTIDn, WholerowhoặcWholerown, vì hệ thống lõi có thể tạo kèo bóng đá c1 cột rác của kèo bóng đá c1 tên này. Nếu kèo bóng đá c1 biểu thức bổ sung phức tạp hơn kèo bóng đá c1 vars đơn giản, chúng phải được chạy quaeval_const_expressionsTrước khi thêm chúng vào danh sách mục tiêu.

Mặc dù chức năng này được gọi trong quá trình lập kế hoạch, thông tin được cung cấp một chút khác biệt so với kèo bóng đá c1 thói quen lập kế hoạch khác.Parsetreelà cây phân tích choCập nhậthoặcXóaLệnh, trong khitarget_rtevàTarget_RelationMô tả Bàn nước kèo bóng đá c1 đích.

NếuCon trỏ được đặt thànhnull, không có biểu thức mục tiêu bổ sung nào được thêm vào. (Điều này sẽ khiến nó không thể thực hiệnXóahoạt động, mặc dùCập nhậtCó thể vẫn khả thi nếu FDW dựa vào khóa chính không thay đổi để xác định hàng.)

Danh sách *

Thực hiện bất kỳ hành động lập kế hoạch bổ sung nào cần thiết để chèn, cập nhật hoặc xóa trên bàn nước kèo bóng đá c1. Chức năng này tạo ra thông tin FDW-Private sẽ được đính kèm vớiModifyTableKế hoạch nút thực hiện hành động cập nhật. Thông tin cá nhân này phải có dạng ADanh sáchvà sẽ được chuyển đếnBeginForignModifyTrong giai đoạn thực thi.

rootlà thông tin toàn cầu kèo bóng đá c1 người lập kế hoạch về truy vấn.PlanlàModifyTableKế hoạch nút, hoàn thành ngoại trừFDWPRIVLISStrường.ResultrelationXác định bảng nước kèo bóng đá c1 mục tiêu theo chỉ mục bảng phạm vi của nó.Subplan_indexXác định mục tiêu nào kèo bóng đá c1ModifyTableKế hoạch nút Đây là, đếm từ số không; Sử dụng cái này nếu bạn muốn lập chỉ mục vàoPlan- kế hoạchhoặc cấu trúc phụ khác kèo bóng đá c1PlanNode.

xemPhần 57.4Để biết thêm thông tin.

NếuPlanForignModifyCon trỏ được đặt thànhNULL, Không có hành động thời gian kế hoạch bổ sung nào được thực hiện vàFDW_PrivateDanh sách được giao choBeginForignModifysẽ là nil.

Void

Bắt đầu thực hiện hoạt động sửa đổi bàn nước kèo bóng đá c1. Thói quen này được gọi trong quá trình khởi động thực thi.EXECFORIGNINSERT, EXECFORIGNUPDATEhoặcEXECFORIGNDELETEsẽ được kèo bóng đá c1 cho mỗi Tuple được chèn, cập nhật hoặc xóa.

MTSTATElà trạng thái tổng thể kèo bóng đá c1ModifyTableKế hoạch nút được thực thi; Dữ liệu toàn cầu về kế hoạch và trạng thái thực thi có sẵn thông qua cấu trúc này.rinfolàresultrelInfoCấu trúc mô tả bảng nước kèo bóng đá c1 mục tiêu. (TheRI_FDWSTATEtrường kèo bóng đá c1resultrelInfoCó sẵn cho FDW để lưu trữ bất kỳ trạng thái riêng tư nào mà nó cần cho hoạt động này.)FDW_PrivateChứa dữ liệu riêng được tạo bởiplanforeignmodify, nếu có.Subplan_indexXác định mục tiêu nào kèo bóng đá c1ModifyTableKế hoạch nút này.EFLAGSChứa kèo bóng đá c1 bit cờ mô tả chế độ hoạt động của người thực thi cho nút kế hoạch này.

Lưu ý rằng khi(EFLAGS & EXEC_FLAG_EXPLAIN_ONLY)là đúng, chức năng này không nên thực hiện bất kỳ hành động nào có thể nhìn nhận được; nó chỉ nên làm tối thiểu cần thiết để làm cho trạng thái nút hợp lệ choGiải thích trước khi điều chỉnhvàendforeignmodify.

NếuBeginForignModifyCon trỏ được đặt thànhnull, không có hành động nào được thực hiện trong quá trình khởi động thực thi.

tupletableslot *

Chèn một tuple vào Bàn nước kèo bóng đá c1.EstateTrạng thái thực thi toàn cầu cho truy vấn.rinfolàresultrelInfoCấu trúc mô tả bảng nước kèo bóng đá c1 đích.slotchứa bộ tuple được chèn; Nó sẽ khớp với định nghĩa loại hàng của Bàn nước kèo bóng đá c1.SP rapchứa bộ tuple được tạo bởiModifyTableSubplan kèo bóng đá c1 Node kế hoạch; nó khác vớislotTrong có thể chứa bổ sungrácCột. (TheSP rapthường là ít quan tâm choChèntrường hợp, nhưng được cung cấp cho sự hoàn chỉnh.)

Giá trị trả về là một khe chứa dữ liệu thực sự được chèn (điều này có thể khác với dữ liệu được cung cấp, ví dụ như là kết quả của kèo bóng đá c1 hành động kích hoạt) hoặc null nếu không có hàng nào được chèn (một lần nữa, thường là kết quả của trình kích hoạt). Thông quaslotcó thể được sử dụng lại cho mục đích này.

Dữ liệu trong khe được trả về chỉ được sử dụng nếuChènTruy vấn cóTrở vềmệnh đề hoặc bàn nước kèo bóng đá c1 cósau hàngTrigger. Trình kích hoạt yêu cầu tất cả kèo bóng đá c1 cột, nhưng FDW có thể chọn tối ưu hóa việc trả về một số hoặc tất cả kèo bóng đá c1 cột tùy thuộc vào nội dung củaTrở vềmệnh đề. Bất kể, một số khe phải được trả lại để biểu thị thành công, hoặc số lượng hàng được báo cáo kèo bóng đá c1 truy vấn sẽ sai.

NếuEXECFORIGNINSERTCon trỏ được đặt thànhnull, Cố gắng chèn vào Bàn nước kèo bóng đá c1 sẽ thất bại với thông báo lỗi.

Lưu ý rằng chức năng này cũng được gọi khi chèn kèo bóng đá c1 bộ dữ liệu được định tuyến vào phân vùng bàn nước ngoài hoặc thực thiSao chép từTrên bàn nước kèo bóng đá c1, trong trường hợp đó nó được gọi theo một cách khác so với trongChèntrường hợp. Xem kèo bóng đá c1 chức năng gọi lại được mô tả bên dưới cho phép FDW hỗ trợ điều đó.

tupletableslot *

Cập nhật một tuple trong Bàn nước kèo bóng đá c1.Estatelà trạng thái thực thi toàn cầu cho truy vấn.rinfolàresultrelInfoCấu trúc mô tả bảng nước kèo bóng đá c1 mục tiêu.slotChứa dữ liệu mới cho tuple; Nó sẽ khớp với định nghĩa loại hàng của Bàn nước kèo bóng đá c1.SP rapchứa bộ tuple được tạo bởiModifyTableSubplan kèo bóng đá c1 Node kế hoạch; nó khác vớislotTrong có thể chứa bổ sungMạnhráccột. Cụ thể, bất kỳ cột rác nào được yêu cầu bởisẽ có sẵn từ khe này.

Giá trị trả về là một khe chứa hàng vì nó thực sự được cập nhật (điều này có thể khác với dữ liệu được cung cấp, ví dụ như kết quả của kèo bóng đá c1 hành động kích hoạt) hoặc null nếu không có hàng nào được cập nhật (một lần nữa, thường là kết quả của kèo bóng đá c1 trình kích hoạt). Thông quaslotcó thể được sử dụng lại cho mục đích này.

Dữ liệu trong khe được trả về chỉ được sử dụng nếuCập nhậtTruy vấn cóTrở vềmệnh đề hoặc Bàn nước kèo bóng đá c1 cósau hàngTrigger. Trình kích hoạt yêu cầu tất cả kèo bóng đá c1 cột, nhưng FDW có thể chọn tối ưu hóa việc trả về một số hoặc tất cả kèo bóng đá c1 cột tùy thuộc vào nội dung củaTrở vềmệnh đề. Bất kể, một số khe phải được trả lại để biểu thị thành công, hoặc số lượng hàng được báo cáo kèo bóng đá c1 truy vấn sẽ sai.

NếuEXECFORIGNUPDATECon trỏ được đặt thànhnull, cố gắng cập nhật bảng nước kèo bóng đá c1 sẽ thất bại với thông báo lỗi.

tupletableslot *

Xóa một tuple khỏi Bàn nước kèo bóng đá c1.EstateTrạng thái thực thi toàn cầu cho truy vấn.rinfolàresultrelInfoCấu trúc mô tả bảng nước kèo bóng đá c1 đích.slotKhông chứa gì hữu ích khi kèo bóng đá c1, nhưng có thể được sử dụng để giữ tuple đã trả lại.SP rapchứa bộ tuple được tạo bởiModifyTableSubplan kèo bóng đá c1 Node kế hoạch; Cụ thể, nó sẽ mang bất kỳ cột rác nào được yêu cầu bởi. (kèo bóng đá c1) cột rác phải được sử dụng để xác định tuple sẽ bị xóa.

Giá trị trả về là một khe chứa hàng đã bị xóa hoặc null nếu không có hàng nào bị xóa (thường là kết quả của kèo bóng đá c1 kích hoạt). Thông quaslotcó thể được sử dụng để giữ tuple để được trả về.

Dữ liệu trong khe được trả về chỉ được sử dụng nếuXóaTruy vấn cóTrở vềmệnh đề hoặc Bàn nước kèo bóng đá c1 cósau hàngTrigger. Trình kích hoạt yêu cầu tất cả kèo bóng đá c1 cột, nhưng FDW có thể chọn tối ưu hóa việc trả về một số hoặc tất cả kèo bóng đá c1 cột tùy thuộc vào nội dung củaTrở vềmệnh đề. Bất kể, một số khe phải được trả lại để biểu thị thành công, hoặc số lượng hàng được báo cáo kèo bóng đá c1 truy vấn sẽ sai.

NếuExecforeIgnDeleteCon trỏ được đặt thànhnull, Cố gắng xóa khỏi Bàn nước kèo bóng đá c1 sẽ thất bại với thông báo lỗi.

VOID

Kết thúc bản cập nhật bảng và phát hành tài nguyên. Thông thường không quan trọng để phát hành bộ nhớ palloc'd, nhưng ví dụ: mở kèo bóng đá c1 tệp và kết nối với kèo bóng đá c1 máy chủ từ xa nên được làm sạch.

NếuFendForignModifyCon trỏ được đặt thànhnull, không có hành động nào được thực hiện trong quá trình tắt máy thực thi.

Tuples được chèn vào bảng được phân vùng bởiChènhoặcSao chép từđược chuyển đến kèo bóng đá c1 phân vùng. Nếu FDW hỗ trợ kèo bóng đá c1 phân vùng bảng nước ngoài có thể định kỳ, nó cũng sẽ cung cấp kèo bóng đá c1 chức năng gọi lại sau.Sao chép từđược thực thi trên bàn nước kèo bóng đá c1.

VOID

Bắt đầu thực hiện một thao tác chèn trên bàn nước kèo bóng đá c1. Thói quen này được gọi ngay trước khi tuple đầu tiên được chèn vào Bàn nước kèo bóng đá c1 trong cả hai trường hợp khi đó là phân vùng được chọn để định tuyến Tuple và mục tiêu được chỉ định trong ASao chép từlệnh. Nó sẽ thực hiện bất kỳ khởi tạo cần thiết trước khi chèn thực tế.EXECFORIGNINSERTsẽ được gọi cho mỗi tuple được chèn vào bàn nước kèo bóng đá c1.

MTSTATElà trạng thái tổng thể kèo bóng đá c1ModifyTableKế hoạch nút được thực thi; Dữ liệu toàn cầu về kế hoạch và trạng thái thực thi có sẵn thông qua cấu trúc này.rinfolàresultrelInfoCấu trúc mô tả bảng nước kèo bóng đá c1 mục tiêu. (TheRI_FDWSTATEtrường kèo bóng đá c1resultrelInfoCó sẵn cho FDW để lưu trữ bất kỳ trạng thái riêng tư nào mà nó cần cho hoạt động này.)

Khi điều này được kèo bóng đá c1 bởiSao chép từLệnh, dữ liệu toàn cầu liên quan đến kế hoạch trongMTSTATEkhông được cung cấp vàSP raptham số kèo bóng đá c1EXECFORIGNINSERTSau đó được kèo bóng đá c1 cho mỗi bộ tuple được chèn lànull, cho dù bảng nước kèo bóng đá c1 là phân vùng được chọn để định tuyến tuple hay mục tiêu được chỉ định trong lệnh.

NếuBeginForignInsertCon trỏ được đặt thànhnull, không có hành động nào được thực hiện để khởi tạo.

Lưu ý rằng nếu FDW không hỗ trợ kèo bóng đá c1 phân vùng bảng nước ngoài có thể định kỳ và/hoặc thực thiSao chép từTrên kèo bóng đá c1 bảng nước ngoài, chức năng này hoặcEXECFORIGNINSERTSau đó được kèo bóng đá c1 là phải ném lỗi khi cần thiết.

VOID

Kết thúc hoạt động chèn và tài nguyên phát hành. Thông thường không quan trọng để phát hành bộ nhớ palloc'd, nhưng ví dụ: mở kèo bóng đá c1 tệp và kết nối với kèo bóng đá c1 máy chủ từ xa nên được làm sạch.

Nếu42258_42276Con trỏ được đặt thànhnull, không có hành động nào được thực hiện để chấm dứt.

int

Báo cáo cập nhật kèo bóng đá c1 hoạt động của Bàn nước ngoài được chỉ định. Giá trị trả về phải là một chút mặt nạ của kèo bóng đá c1 số sự kiện quy tắc cho biết kèo bóng đá c1 hoạt động nào được hỗ trợ bởi Bàn nước ngoài, sử dụngcmdtypeliệt kê; đó là,(1 << cmd_update) = 4choCập nhật, (1 << cmd_insert) = 8choChènvà(1 << cmd_delete) = 16choXóa.

NếuisforeignRelupDatableCon trỏ được đặt thànhnull, kèo bóng đá c1 bảng nước ngoài được coi là có thể chèn, cập nhật hoặc có thể phân loại nếu FDW cung cấpEXECFORIGNINSERT, ExecforeIgnupDatehoặcExecforeIgnDeletetương ứng. Hàm này chỉ cần thiết nếu FDW hỗ trợ một số bảng có thể cập nhật và một số bảng không.thông tin_schemaChế độ xem.)

Một số chèn, cập nhật và xóa kèo bóng đá c1 bảng nước ngoài có thể được tối ưu hóa bằng cách triển khai một bộ giao diện thay thế. kèo bóng đá c1 giao diện thông thường để chèn, cập nhật và xóa tìm nạp kèo bóng đá c1 hàng khỏi máy chủ từ xa và sau đó sửa đổi kèo bóng đá c1 hàng đó cùng một lúc.Với tùy chọn kiểm trakèo bóng đá c1 ràng buộc từ kèo bóng đá c1 quan điểm của cha mẹ), sau đó có thể sắp xếp mọi thứ để toàn bộ hoạt động được thực hiện trên máy chủ từ xa. kèo bóng đá c1 giao diện được mô tả bên dưới làm cho điều này có thể.

Bool

Quyết định xem có an toàn để thực hiện sửa đổi trực tiếp trên máy chủ từ xa hay không. Nếu vậy, hãy trả lạiTRUESau khi thực hiện kèo bóng đá c1 hành động lập kế hoạch cần thiết cho điều đó. Nếu không, trở lạiSai. Chức năng tùy chọn này được kèo bóng đá c1 trong quá trình lập kế hoạch truy vấn.BegindirectModify, iteratedirectModifyvàEndDirectModifysẽ được gọi ở giai đoạn thực thi, thay vào đó. Mặt khác, sửa đổi bảng sẽ được thực hiện bằng cách sử dụng kèo bóng đá c1 hàm cập nhật bảng được mô tả ở trên.PlanForignModify.

Để thực hiện sửa đổi trực tiếp trên máy chủ từ xa, chức năng này phải viết lại sơ đồ con mục tiêu bằng mộtForeignScanKế hoạch nút thực hiện sửa đổi trực tiếp trên máy chủ từ xa. TheHoạt độngTrường kèo bóng đá c1ForeignScanphải được đặt thànhcmdtypeliệt kê một cách thích hợp; đó là,CMD_UPDATEchoCập nhật, cmd_insertchoChènvàcmd_deletechoXóa.

xemPhần 57.4Để biết thêm thông tin.

NếuPlandirectModifyCon trỏ được đặt thànhNULL, Không cố gắng thực hiện sửa đổi trực tiếp trên máy chủ từ xa được thực hiện.

VOID

Chuẩn bị thực hiện sửa đổi trực tiếp trên máy chủ từ xa. Điều này được kèo bóng đá c1 trong quá trình khởi động thực thi.iteratedirectModify). Thenước kèo bóng đá c1Node đã được tạo, nhưng nófdw_stateTrường vẫn còn vô hiệu. Thông tin về bảng để sửa đổi có thể truy cập được thông quaForeignScanStatenút (đặc biệt, từ bên dướiForeignScanKế hoạch nút, chứa bất kỳ thông tin FDW-Private nào được cung cấp bởiPlandirectModify).EFLAGSChứa kèo bóng đá c1 bit cờ mô tả chế độ hoạt động của người thực thi cho nút kế hoạch này.

Lưu ý rằng khi(eflags & exec_flag_explain_only)là đúng, chức năng này không nên thực hiện bất kỳ hành động nào có thể nhìn thấy bên kèo bóng đá c1; nó chỉ nên làm tối thiểu cần thiết để làm cho trạng thái nút hợp lệ choGiải thíchDirectModifyvàEndDirectModify.

NếuBegindirectModifyCon trỏ được đặt thànhnull, Không cố gắng thực hiện sửa đổi trực tiếp trên máy chủ từ xa được thực hiện.

tupletableslot *

KhiChèn, Cập nhậthoặcXóaTruy vấn không cóTrở vềmệnh đề, chỉ cần trả lại null sau khi sửa đổi trực tiếp trên máy chủ từ xa. Khi truy vấn có mệnh đề, hãy lấy một kết quả chứa dữ liệu cần thiết cho​​Trở vềTính toán, trả lại trong một khe cắm bảng Tuple (nút kèo bóng đá c1 nútscantuplotlotnên được sử dụng cho mục đích này). Dữ liệu thực sự được chèn, cập nhật hoặc xóa phải được lưu trữ trong48740_48827kèo bóng đá c1 nútEstate. Trả lại null nếu không có nhiều hàng có sẵn.BegindirectModifyNếu bạn cần lưu trữ lâu hơn hoặc sử dụngES_Query_CXTkèo bóng đá c1 nútEstate.

kèo bóng đá c1 hàng được trả về phải khớp vớifdw_scan_tlistDanh sách mục tiêu Nếu được cung cấp, nếu không chúng phải khớp với loại hàng của bàn nước ngoài được cập nhật. Nếu bạn chọn tối ưu hóa kèo bóng đá c1 cột tìm nạp không cần thiết choTrở vềTính toán, bạn nên chèn nulls vào kèo bóng đá c1 vị trí cột đó hoặc khác tạo rafdw_scan_tlistLiệt kê với kèo bóng đá c1 cột bị bỏ qua.

Cho dù truy vấn có mệnh đề hay không, số lượng hàng được báo cáo kèo bóng đá c1 truy vấn phải được tăng lên bởi chính FDW. Khi truy vấn không có mệnh đề, FDW cũng phải tăng số lượng hàng chonước kèo bóng đá c1nút trongGiải thích Phân tíchCASE.

NếuiteratedirectModifyCon trỏ được đặt thànhnull, Không cố gắng thực hiện sửa đổi trực tiếp trên máy chủ từ xa được thực hiện.

Void

Làm sạch sau khi sửa đổi trực tiếp trên máy chủ từ xa. Thông thường không quan trọng để phát hành bộ nhớ palloc'd, nhưng ví dụ: mở kèo bóng đá c1 tệp và kết nối với máy chủ từ xa nên được làm sạch.

NếuEndDirectModifyCon trỏ được đặt thànhnull, Không cố gắng thực hiện sửa đổi trực tiếp trên máy chủ từ xa được thực hiện.

Nếu FDW muốn hỗ trợkhóa hàng muộn(như được mô tả trongPhần 57.5), nó phải cung cấp kèo bóng đá c1 chức năng gọi lại sau:

RowMarkType

Báo cáo tùy chọn đánh dấu hàng nào để sử dụng cho một bàn nước kèo bóng đá c1.​​RTElàRangetBlentrynút cho bảng vàSức mạnhMô tả cường độ khóa được yêu cầu bởi liên quanđể cập nhật/chia sẻmệnh đề, nếu có. Kết quả phải là thành viên kèo bóng đá c1RowMarkTypeLoại Enum.

Hàm này được gọi trong quá trình lập kế hoạch truy vấn cho mỗi bảng nước kèo bóng đá c1 xuất hiện trong mộtCập nhật, XóahoặcChọn để cập nhật/chia sẻTruy vấn và không phải là mục tiêu kèo bóng đá c1Cập nhậthoặcXóa.

NếugetforeignrowmarktypeCon trỏ được đặt thànhnull, TheRow_Mark_CopyTùy chọn luôn được sử dụng. (Điều này ngụ ý rằngRefetchForeIgnrowsẽ không bao giờ được kèo bóng đá c1, vì vậy nó cũng không cần phải được cung cấp.)

xemPhần 57.5Để biết thêm thông tin.

nặng nề

Lấy lại một tuple từ Bàn nước kèo bóng đá c1, sau khi khóa nó nếu được yêu cầu.Estatelà trạng thái thực thi toàn cầu cho truy vấn.ERMlàExecRowMarkCấu trúc mô tả bảng nước kèo bóng đá c1 mục tiêu và loại khóa hàng (nếu có) để có được.ROWIDXác định Tuple sẽ được tìm nạp.Cập nhậtlà tham số đầu ra.

53288_53360nullNếu không thể lấy được khóa hàng. Loại khóa hàng để thu được được xác định bởierm- marktype, là giá trị được trả về trước đó bởigetforeignrowmarktype. (Row_Mark_ReferenceCó nghĩa là chỉ cần lấy lại bộ tuple mà không cần có bất kỳ khóa nào vàRow_Mark_CopySẽ không bao giờ được nhìn thấy bởi thói quen này.)

kèo bóng đá c1 ra,*Cập nhậtnên được đặt thànhTRUENếu những gì được tìm nạp là phiên bản cập nhật kèo bóng đá c1 tuple thay vì cùng một phiên bản thu được trước đó. (Nếu FDW không thể chắc chắn về điều này, hãy luôn quay trở lạiTRUEđược khuyến nghị.)

Lưu ý rằng theo mặc định, việc không có được khóa hàng sẽ dẫn đến việc gây ra lỗi; MộtnullTrả về chỉ phù hợp nếuBỏ qua khóaTùy chọn được chỉ định bởierm- Waitpolicy.

TheROWIDlàCTIDGiá trị đọc trước đây cho hàng được tìm nạp lại. Mặc dùROWIDGiá trị được truyền dưới dạngDatum, hiện tại nó chỉ có thể làtid. API chức năng được chọn với hy vọng rằng có thể cho phép kèo bóng đá c1 loại dữ liệu khác cho ID hàng trong tương lai.

NếuRefetchForeIgnrowCon trỏ được đặt thànhnull, Cố gắng lấy lại kèo bóng đá c1 hàng sẽ không thành công với thông báo lỗi.

xemPhần 57.5Để biết thêm thông tin.

Bool

Kiểm tra rằng một tuple đã được trả lại trước đó vẫn phù hợp với vòng loại quét và tham gia kèo bóng đá c1 vòng loại có liên quan và có thể cung cấp một phiên bản sửa đổi của tuple. Đối với kèo bóng đá c1 trình bao bọc dữ liệu nước ngoài không thực hiện tham gia Pushdown, thông thường sẽ thuận tiện hơn để đặt điều này thànhnullvà thay vào đó đặtFDW_RECHECK_QUALSmột cách thích hợp. Tuy nhiên, khi kèo bóng đá c1 kết nối bên ngoài được đẩy xuống, tuy nhiên, việc áp dụng lại kèo bóng đá c1 kiểm tra có liên quan đến tất cả kèo bóng đá c1 bảng cơ sở với kết quả là không đủ, ngay cả khi tất cả kèo bóng đá c1 thuộc tính cần thiết đều có mặt, bởi vì không phù hợp với một số vòng loại có thể dẫn đến một số thuộc tính sẽ không được trả lại.RecheckForignScan56043_56199

56209_56393ForeignScan. Khi cần phải kiểm tra lại, sơ đồ con này có thể được thực thi và bộ tuple kết quả có thể được lưu trữ trong khe.GetExistingLocaljoinPathCó thể được sử dụng để tìm kiếm kèo bóng đá c1 đường dẫn hiện có cho đường dẫn tham gia cục bộ phù hợp, có thể được sử dụng làm kế hoạch tham gia cục bộ thay thế.GetExistingLocalJoinPathTìm kiếm một đường dẫn không phân chia trong danh sách đường dẫn kèo bóng đá c1 mối quan hệ tham gia được chỉ định. .

VOID

In bổ sungGiải thíchđầu ra cho quét bảng nước kèo bóng đá c1. Chức năng này có thể gọiGiải thíchPropertyTextvà kèo bóng đá c1 chức năng liên quan để thêm kèo bóng đá c1 trường vàoGiải thíchđầu ra. kèo bóng đá c1 trường cờ trongesCó thể được sử dụng để xác định những gì cần in và trạng thái kèo bóng đá c1ForeignScanStateNode có thể được kiểm tra để cung cấp số liệu thống kê thời gian chạy trongGiải thích Phân tíchCASE.

NếuGiải thích FormentIgnScanCon trỏ được đặt thànhnull, Không có thông tin bổ sung nào được in trongGiải thích.

VOID

In bổ sungGiải thíchđầu ra cho bản cập nhật bàn nước kèo bóng đá c1. Chức năng này có thể gọiGiải thíchPropertyTextvà kèo bóng đá c1 chức năng liên quan để thêm kèo bóng đá c1 trường vàoGiải thíchđầu ra. kèo bóng đá c1 trường cờ trongescó thể được sử dụng để xác định những gì cần in và trạng thái kèo bóng đá c1ModifyTablestateNode có thể được kiểm tra để cung cấp số liệu thống kê thời gian chạy trongGiải thích Phân tíchtrường hợp. Bốn đối số đầu tiên giống như đối vớiBeginForignModify.

NếuGiải thích trước khi điều chỉnhCon trỏ được đặt thànhnull, Không có thông tin bổ sung nào được in trongGiải thích.

VOID

In bổ sungGiải thíchđầu ra để sửa đổi trực tiếp trên máy chủ từ xa. Chức năng này có thể kèo bóng đá c1Giải thíchPropertyTextvà kèo bóng đá c1 chức năng liên quan để thêm kèo bóng đá c1 trường vàoGiải thíchđầu ra. kèo bóng đá c1 trường cờ trongesCó thể được sử dụng để xác định những gì cần in và trạng thái kèo bóng đá c1ForeignScanStateNode có thể được kiểm tra để cung cấp số liệu thống kê thời gian chạy trongGiải thích Phân tíchCASE.

NếuGiải thíchDirectModifyCon trỏ được đặt thànhnull, Không có thông tin bổ sung nào được in trongGiải thích.

Bool

Hàm này được kèo bóng đá c1 khiPhân tíchđược thực hiện trên bàn nước kèo bóng đá c1. Nếu FDW có thể thu thập số liệu thống kê cho Bàn nước kèo bóng đá c1 này, nó sẽ trả lạiTRUE, và cung cấp một con trỏ đến một hàm sẽ thu thập kèo bóng đá c1 hàng mẫu từ bảng trongfunc, cộng với kích thước ước tính của bảng trong kèo bóng đá c1 trang trongTổng số. Nếu không, trở lạiSai.

Nếu FDW không hỗ trợ thu thập số liệu thống kê cho bất kỳ bảng nào,Phân tích trước khi thiết kếCon trỏ có thể được đặt thànhnull.

Nếu được cung cấp, chức năng thu thập mẫu phải có chữ ký

int

Một mẫu ngẫu nhiên lên đếnTargrowsHàng phải được thu thập từ bảng và được lưu trữ vào người kèo bóng đá c1 được cung cấphàngMảng. Số lượng hàng thực tế được thu thập phải được trả về.TotalRowsvàTotalDeadrows. (BộTotalDeadrowsđến 0 Nếu FDW không có bất kỳ khái niệm nào về hàng chết.)

Danh sách *

Lấy danh sách kèo bóng đá c1 lệnh tạo bảng nước ngoài. Chức năng này được gọi khi thực thiPostgreSQL: Tài liệu: 11:, và được thông qua cây phân tích cho câu lệnh đó, cũng như OID của máy chủ nước ngoài sử dụng. Nó sẽ trả về một danh sách kèo bóng đá c1 chuỗi C, mỗi chuỗi phải chứa mộtPostgreSQL: Tài kèo bóngLệnh. kèo bóng đá c1 chuỗi này sẽ được phân tích cú pháp và thực hiện bởi máy chủ lõi.

trongIntertForignSchemastMTstruct,remote_schemalà tên của lược đồ từ xa mà kèo bóng đá c1 bảng sẽ được nhập.list_typeXác định cách lọc tên bảng:fdw_import_schema_allCó nghĩa là tất cả kèo bóng đá c1 bảng trong lược đồ từ xa nên được nhập (trong trường hợp nàyTable_Listlà trống),fdw_import_schema_limit_tocó nghĩa là chỉ bao gồm kèo bóng đá c1 bảng được liệt kê trongTable_Listvàfdw_import_schema_exceptcó nghĩa là loại trừ kèo bóng đá c1 bảng được liệt kê trongTable_List. Tùy chọnlà danh sách kèo bóng đá c1 tùy chọn được sử dụng cho quy trình nhập. Ý nghĩa của kèo bóng đá c1 tùy chọn là tùy thuộc vào FDW.không nullThuộc tính của kèo bóng đá c1 cột phải được nhập. kèo bóng đá c1 tùy chọn này không cần phải làm gì với kèo bóng đá c1 tùy chọn được FDW hỗ trợ làm tùy chọn đối tượng cơ sở dữ liệu.

FDW có thể bỏ qualocal_schemaTrường kèo bóng đá c164682_64707, vì máy chủ lõi sẽ tự động chèn tên đó vào phân tích cú phápTạo bảng nước kèo bóng đá c1lệnh.

FDW không phải quan tâm đến việc thực hiện bộ lọc được chỉ định bởilist_typevàTable_List, vì máy chủ lõi sẽ tự động bỏ qua bất kỳ lệnh nào được trả về cho kèo bóng đá c1 bảng được loại trừ theo kèo bóng đá c1 tùy chọn đó. Tuy nhiên, thường rất hữu ích để tránh công việc tạo kèo bóng đá c1 lệnh cho kèo bóng đá c1 bảng bị loại trừ ngay từ đầu.isimportable eforignTable ()Có thể hữu ích để kiểm tra xem một tên bàn nước kèo bóng đá c1 nhất định sẽ vượt qua bộ lọc.

Nếu FDW không hỗ trợ nhập định nghĩa bảng,IntertForignSchemaCon trỏ có thể được đặt thànhnull.

Anước kèo bóng đá c1Node có thể, tùy chọn, hỗ trợ thực thi song song. Một song songnước kèo bóng đá c1sẽ được thực thi trong nhiều quy trình và phải trả về từng hàng chính xác một lần trên tất cả kèo bóng đá c1 quy trình hợp tác. Để làm điều này, kèo bóng đá c1 quá trình có thể phối hợp thông qua kèo bóng đá c1 khối có kích thước cố định của bộ nhớ chia sẻ động.

Bool

Kiểm tra xem có thể thực hiện quét trong một công nhân song song hay không. Hàm này sẽ chỉ được kèo bóng đá c1 khi người lập kế hoạch tin rằng một kế hoạch song song có thể là có thể và sẽ trả về đúng nếu nó an toàn cho việc quét đó để chạy trong một công nhân song song.

Nếu chức năng này không được xác định, người ta cho rằng việc quét phải diễn ra trong Trưởng nhóm song song. Lưu ý rằng việc trả về true không có nghĩa là bản thân quá trình quét có thể được thực hiện song song, chỉ có thể thực hiện quét trong một công nhân song song.

Kích thước

Ước tính lượng bộ nhớ chia sẻ động sẽ được yêu cầu cho hoạt động song song. Điều này có thể cao hơn số lượng thực sự sẽ được sử dụng, nhưng nó không được thấp hơn.

Void

Khởi tạo bộ nhớ chia sẻ động sẽ được yêu cầu cho hoạt động song song.tọa độChỉ vào vùng bộ nhớ được chia sẻ có kích thước bằng với giá trị trả về kèo bóng đá c1Ước tínhSmforignScan. Chức năng này là tùy chọn và có thể được bỏ qua nếu không cần thiết.

Void

Tái tạo bộ nhớ chia sẻ động cần thiết cho hoạt động song song khi nút Kế hoạch quét nước kèo bóng đá c1 sắp được quét lại. Chức năng này là tùy chọn và có thể được bỏ qua nếu không cần thiết.RescanForignScanChức năng chỉ đặt lại trạng thái cục bộ. Hiện tại, chức năng này sẽ được kèo bóng đá c1 trướcRescanForignScan, nhưng tốt nhất là không dựa vào thứ tự đó.

VOID

Khởi tạo trạng thái cục bộ kèo bóng đá c1 công nhân song song dựa trên trạng thái chia sẻ do người lãnh đạo thiết lập trongkhởi tạoSmforeignScan. Chức năng này là tùy chọn và có thể được bỏ qua nếu không cần thiết.

Void

Phát hành tài nguyên khi dự đoán, nút sẽ không được thực hiện để hoàn thành. Điều này không được gọi trong tất cả kèo bóng đá c1 trường hợp;FendForignScanCó thể được gọi mà không có chức năng này được gọi là đầu tiên. Vì phân đoạn DSM được sử dụng bởi truy vấn song song bị phá hủy ngay sau khi cuộc gọi lại này được gọi, kèo bóng đá c1 trình bao bọc dữ liệu nước ngoài muốn thực hiện một số hành động trước khi phân đoạn DSM biến mất nên thực hiện phương pháp này.

Danh sách *

Hàm này được gọi trong khi chuyển đổi một đường dẫn được tham số được tham số bởi cha mẹ hàng đầu kèo bóng đá c1 mối quan hệ con đã choChild_Relđược tham số hóa bởi quan hệ con cái. Chức năng được sử dụng để sắp xếp lại bất kỳ đường dẫn nào hoặc dịch bất kỳ nút biểu thức nào được lưu trong đã choFDW_PrivateThành viên kèo bóng đá c1 AForeignPath. Cuộc kèo bóng đá c1 lại có thể sử dụngreparameterize_path_by_child, điều chỉnh_appendrel_attrshoặcđiều chỉnh_appendrel_attrs_multileveltheo yêu cầu.