Void

Lấy ước tính kích thước quan hệ cho một bảng nước kèo bóng đá pháp. Đ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 đá pháp.rootlà thông tin toàn cầu kèo bóng đá pháp người lập kế hoạch về truy vấn;Baserellà thông tin kèo bóng đá pháp 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 đá pháp. (ForeignTableIDcó thể được lấy từ kèo bóng đá pháp 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 đá pháp 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 đá pháp 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 đá pháp. (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 56.4Để biết thêm thông tin.

Void

Tạo kèo bóng đá pháp đườ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 đá pháp.

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 đá pháp và phải gọiadd_pathĐể thêm từng đườ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Để biểu thị 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 đá pháp ướ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 56.4Để biết thêm thông tin.

ForeignScan *

Tạo AForeignScanKế hoạch nút từ đường dẫn truy cập nước kèo bóng đá pháp đã 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 đá pháp đ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 kèo bóng đá pháp đượ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 56.4Để biết thêm thông tin.

Void

Bắt đầu thực hiện quét nước kèo bóng đá pháp. Điều này được gọi trong quá trình khởi động thực thi.itaterforeignScan). TheForeignScanStateNode đã được tạo, nhưng nóFDW_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 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ởiGetforeignplan).EFLAGSChứa kèo bóng đá pháp 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 đá pháp, trả lại trong khe cắm bảng Tuple (nút của nútscantuplotlotnên được sử dụng cho mục đích này). Trả kèo bóng đá pháp 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 đá pháp nútEstate.

kèo bóng đá pháp 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 đá pháp cột tìm nạp không cần thiết, bạn nên chèn kèo bóng đá pháp null vào kèo bóng đá pháp vị trí cột đó, hoặc nếu không sẽ tạo rafdw_scan_tlistLiệt kê với kèo bóng đá pháp cột bị bỏ qua.

Lưu ý rằngPostgreSQLNgười thực thi không quan tâm liệu kèo bóng đá pháp 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 quan tâm và có thể tối ưu hóa kèo bóng đá pháp truy vấn không chính xác nếu có kèo bóng đá pháp 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 kèo bóng đá pháp 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 đá pháp tệp và kết nối với kèo bóng đá pháp 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 đá pháp 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 đá pháp đườ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 gia(Sử dụngcreated_forign_join_pathĐể xây dựng chúng) và kèo bóng đá phápadd_pathĐể thêm kèo bóng đá pháp đường dẫn này vào tập hợp kèo bóng đá pháp đường dẫn được xem xét cho sự tham gia. Nhưng không giống nhưGetForignPaths, Không nhất 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 đá pháp đườ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 đá pháp 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 đá pháp đường dẫn được tạo cho kèo bóng đá pháp bảng thành phần và kèo bóng đá pháp công ty con sẽ không được sử dụng.ScanRelidkèo bóng đá pháp kết quảForeignScanKế 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 đá phápForeignScanNode đại diện cho tập hợp kèo bóng đá pháp mối quan hệ đã được nối. .fdw_scan_tlistVới danh sách thích hợpTargetEntrykèo bóng đá pháp nút, đại diện cho tập hợp kèo bóng đá pháp cột nó sẽ cung cấp trong thời gian chạy trong kèo bóng đá pháp bộ dữ liệu mà nó trả về.

xemPhần 56.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 đá pháp lại này:

VOID

Tạo đường dẫn truy cập có thể choquan 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 đá pháp xử lý 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 nào mà FDW biết cách thực hiện từ xa (sử dụngcreated_forign_upper_pathĐể xây dựng chúng) và kèo bóng đá phápadd_pathĐể thêm kèo bóng đá pháp đườ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 đá pháp đườ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 đá pháp đườ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; hoặc choupperrel_final, trong trường hợp đó nó chỉ vào AFinalPathExtradataCấ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 đá pháp đườ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 đá pháp đườ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 56.4Để biết thêm thông tin.

Nếu FDW hỗ trợ kèo bóng đá pháp 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 đá pháp 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 đá pháp hàng trước đây được tìm nạp bởi kèo bóng đá pháp 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 đá pháp giá trị của kèo bóng đá pháp 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 đá pháp cột mục tiêu vào danh sách kèo bóng đá pháp 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 đá pháp biểu thức cho kèo bóng đá pháp 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ó riêng 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 đá pháp cột rác của kèo bóng đá pháp tên này. Nếu kèo bóng đá pháp biểu thức bổ sung phức tạp hơn kèo bóng đá pháp 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 đích.

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 hơi khác so với kèo bóng đá pháp 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 đá pháp đích.

NếuCon trỏ được đặt thànhnull, không có biểu thức mục tiêu 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ậtvẫn có thể 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 đá pháp. 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 AListvà sẽ được chuyển đếnBeginForignModifyTrong giai đoạn thực thi.

rootlà thông tin toàn cầu kèo bóng đá pháp người lập kế hoạch về truy vấn.PlanlàModifyTableKế hoạch nút, hoàn thành ngoại trừFDWPrivlisttrường.ResultrelationXác định bảng nước kèo bóng đá pháp 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 đá phápModifyTableKế 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 đá phápPlanNode.

xemPhần 56.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 chuyển đếnBeginForignModifysẽ là nil.

Void

Bắt đầu thực hiện hoạt động sửa đổi bàn nước kèo bóng đá pháp. 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 đá pháp 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 đá phápModifyTableKế hoạch nút được thực thi; Dữ kèo bóng đá pháp 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 đá pháp mục tiêu. (TheRI_FDWSTATEtrường kèo bóng đá phápresultrelInfoCó 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ữ kèo bóng đá pháp riêng được tạo bởiPlanforeignModify, nếu có.Subplan_indexXác định mục tiêu nào kèo bóng đá phápModifyTableKế hoạch nút này.EFLAGSChứa kèo bóng đá pháp 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 đá pháp.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 đá pháp mục tiêu.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 đá pháp.PRANLOTchứa bộ tuple được tạo bởiModifyTablekế hoạch con kèo bóng đá pháp nút kế hoạch; nó khác vớislotTrong có thể chứa bổ sungrácCột. (TheSP rapthường rất í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 đá pháp 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 kèo bóng đá pháp cho mục đích này.

Dữ kèo bóng đá pháp trong khe được trả về chỉ được sử dụng nếuChènCâu lệnh cóTrở vềmệnh đề hoặc liên quan đến chế độ xemVới tùy chọn kiểm tra; hoặc nếu Bàn nước kèo bóng đá pháp cósau hàngTrigger. Trình kích hoạt yêu cầu tất cả kèo bóng đá pháp 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 đá pháp cột tùy thuộc vào nội dung củaTrở vềmệnh đề hoặcVới tùy chọn kiểm traràng buộc. 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 đá pháp 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 đá pháp 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 đá pháp 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 đá pháp, 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 đá pháp 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 đá pháp.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 đá pháp đích.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 đá pháp.SP rapchứa bộ tuple được tạo bởiModifyTableSubplan kèo bóng đá pháp Node kế hoạch; nó khác vớislotTrong có thể chứa bổ sungrácHồiCộ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 đá pháp hành động kích hoạt) hoặc null nếu không có hàng thực sự được cập nhật (một lần nữa, thường là kết quả của kèo bóng đá pháp trình kích hoạt). Thông quaslotcó thể được sử dụng kèo bóng đá pháp cho mục đích này.

Dữ kèo bóng đá pháp trong khe được trả về chỉ được sử dụng nếuCập nhậtCâu lệnh cóTrở vềmệnh đề hoặc liên quan đến chế độ xemVới tùy chọn kiểm tra; hoặc nếu Bàn nước kèo bóng đá pháp cósau hàngTrigger. Trình kích hoạt yêu cầu tất cả kèo bóng đá pháp 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 đá pháp cột tùy thuộc vào nội dung củaTrở vềmệnh đề hoặcVới tùy chọn kiểm traràng buộc. 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 đá pháp 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 đá pháp 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 đá pháp.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 đá pháp đích.slotKhông chứa gì hữu ích khi kèo bóng đá pháp, nhưng có thể được sử dụng để giữ tuple trả về.SP rapchứa bộ tuple được tạo bởiModifyTableSubplan kèo bóng đá pháp 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 đá pháp) 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 đá pháp kích hoạt). Thông quaslotcó thể được sử dụng để giữ phần mềm để được trả về.

Dữ kèo bóng đá pháp trong khe 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 đá pháp cósau hàngTrigger. Trình kích hoạt yêu cầu tất cả kèo bóng đá pháp 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 đá pháp 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 đá pháp 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 đá pháp 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 đá pháp tệp và kết nối với kèo bóng đá pháp 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 đá pháp phân vùng. Nếu FDW hỗ trợ kèo bóng đá pháp 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 đá pháp 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 đá pháp.

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 đá pháp. 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 đá pháp 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 trongSao 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ế.ExecforeIgnInsertsẽ được gọi cho mỗi tuple được chèn vào Bàn nước kèo bóng đá pháp.

MTSTATElà trạng thái tổng thể kèo bóng đá phápModifyTableKế hoạch nút được thực thi; Dữ kèo bóng đá pháp 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 đá pháp mục tiêu. (TheRI_FDWSTATEtrường kèo bóng đá phápresultrelInfoCó 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 đá pháp bởi ASao chép từLệnh, dữ kèo bóng đá pháp 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 đá phápExecforeIgnInsertSau đó được kèo bóng đá pháp cho mỗi bộ được chèn lànull, cho dù bảng nước kèo bóng đá pháp 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 đá pháp 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 đá pháp bảng nước ngoài, chức năng này hoặcEXECFORIGNINSERTSau đó được kèo bóng đá pháp là phải ném lỗi khi cần.

VOID

Kết thúc hoạt động chèn 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 đá pháp tệp và kết nối với kèo bóng đá pháp máy chủ từ xa nên được làm sạch.

Nếu42444_42462Con 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 đá pháp 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 đá pháp số sự kiện quy tắc cho biết kèo bóng đá pháp 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, Bảng nước kèo bóng đá pháp đượ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_schemaLượt xem.)

Một số chèn, cập nhật và xóa kèo bóng đá pháp 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 đá pháp giao diện thông thường để chèn, cập nhật và xóa tìm nạp kèo bóng đá pháp hàng khỏi máy chủ từ xa và sau đó sửa đổi kèo bóng đá pháp hàng đó cùng một lúc.Với tùy chọn kiểm trakèo bóng đá pháp ràng buộc từ kèo bóng đá pháp 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 đá pháp 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ả kèo bóng đá phápTRUESau khi thực hiện kèo bóng đá pháp 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 đá pháp trong quá trình lập kế hoạch truy vấn.BegindirectModify,iteratedirectModifyvàEndDirectModifythay vào đó sẽ được gọi ở giai đoạn thực thi. 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 đá pháp hàm cập nhật bảng được mô tả ở trên.planforeignmodify.

Để 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 kèo bóng đá pháp sơ đồ con đích 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 đá phápForeignScanphả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 56.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 đá pháp trong quá trình khởi động thực thi.iteratedirectModify). TheForeignScanStateNode đã được tạo, nhưng nóFDW_STATETrường vẫn còn null. Thông tin về bảng để sửa đổi có thể truy cập được thông quanước kèo bóng đá phápnú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 đá pháp 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í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ữ kèo bóng đá pháp cần thiết choTrở vềTính toán, trả lại trong khe cắm bảng Tuple (nút kèo bóng đá pháp nútscantuplotlotnên được sử dụng cho mục đích này). Dữ kèo bóng đá pháp thực sự được chèn, cập nhật hoặc xóa phải được lưu trữ trong48953_49040kèo bóng đá pháp nútEstate. Trả kèo bóng đá pháp null nếu không có nhiều hàng có sẵn.BegindirectModifyNế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 đá pháp nútEstate.

kèo bóng đá pháp 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 đá pháp cột tìm nạp không cần thiết choTrở vềTính toán, bạn nên chèn null vào kèo bóng đá pháp vị trí cột đó hoặc khác tạo raFDW_SCAN_TLISTLiệt kê với kèo bóng đá pháp 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 đá pháp 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 choForeignScanStatenú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 đá pháp 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 56.5), nó phải cung cấp kèo bóng đá pháp 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 đá pháp.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 đá phápRowMarkTypeloạ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 đá pháp 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 đá phápCậ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 đá pháp, vì vậy nó cũng không cần phải được cung cấp.)

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

VOID

Lấy lại một khe cắm từ bàn nước kèo bóng đá pháp, 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 đá pháp đích và loại khóa hàng (nếu có) để có được.ROWIDXác định Tuple sẽ được tìm nạp.slotKhông chứa gì hữu ích khi kèo bóng đá pháp, nhưng có thể được sử dụng để giữ Tuple trả về.Cập nhậtlà tham số đầu ra.

Hàm này sẽ lưu trữ bộ tuple vào khe được cung cấp hoặc xóa nó nếu không thể thu đượ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 đógetforeignrowmarktype. (Row_Mark_Referencecó nghĩa là chỉ cần lấy kèo bóng đá pháp 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 đá pháp 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 đá pháp 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; Trả kèo bóng đá pháp với một khe trống 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 kèo bóng đá pháp. 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 đá pháp 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 tìm nạp lại kèo bóng đá pháp hàng sẽ không thành công với thông báo lỗi.

xemPhần 56.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 đá pháp 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 đá pháp 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 đá pháp 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 đá pháp kiểm tra có liên quan đến tất cả kèo bóng đá pháp bảng cơ sở với kết quả là không đủ, ngay cả khi tất cả kèo bóng đá pháp 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.56339_5635956364_56520

Để thực hiện tham gia Pushdown, một trình bao bọc dữ liệu nước kèo bóng đá pháp thường sẽ xây dựng một kế hoạch tham gia cục bộ thay thế chỉ được sử dụng để kiểm tra lại; Điều này sẽ trở thành kế hoạch con bên kèo bóng đá pháp củaForeignScan. Khi cần phải kiểm tra kèo bóng đá pháp, 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 đá pháp đườ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 đá pháp 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 đá pháp. Chức năng này có thể gọiGiải thíchPropertyTextvà kèo bóng đá pháp chức năng liên quan để thêm kèo bóng đá pháp trường vàoGiải thíchđầu ra. kèo bóng đá pháp 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 đá phápForeignScanstateNode có thể được kiểm tra để cung cấp số kèo bóng đá pháp thống kê thời gian chạy trongGiải thích Phân tíchCASE.

NếuGiải thích trước khi inCon 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 đá pháp. Chức năng này có thể gọiGiải thíchPropertyTextvà kèo bóng đá pháp chức năng liên quan để thêm kèo bóng đá pháp trường vàoGiải thíchđầu ra. kèo bóng đá pháp 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 đá phápModifyTablestateNode có thể được kiểm tra để cung cấp số kèo bóng đá pháp 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 đá phápGiải thíchPropertyTextvà kèo bóng đá pháp chức năng liên quan để thêm kèo bóng đá pháp trường vàoGiải thíchđầu ra. kèo bóng đá pháp 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 đá phápForeignScanstateNode có thể được kiểm tra để cung cấp số kèo bóng đá pháp 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 đá pháp khiPhân tíchđược thực hiện trên bàn nước kèo bóng đá pháp. Nếu FDW có thể thu thập số liệu thống kê cho Bàn nước kèo bóng đá pháp này, nó sẽ trả lạiTRUE, và cung cấp một con trỏ cho một hàm sẽ thu thập kèo bóng đá pháp 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 đá pháp trang trongTotalPages. Nếu không, trở kèo bóng đá phápSai.

Nếu FDW không hỗ trợ thu thập số kèo bóng đá pháp 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 đá pháp đượ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 đá pháp lệnh tạo bảng nước ngoài. Chức năng này được gọi khi thực thiNhập lược đồ nước kèo bóng đá phápvà đượ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 đá pháp chuỗi C, mỗi chuỗi phải chứa mộtTạo bảng nước kèo bóng đá phápLệnh. kèo bóng đá pháp 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.

trong63801_63826struct,remote_schemalà tên của lược đồ từ xa mà kèo bóng đá pháp 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 đá pháp 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 đá pháp bảng được liệt kê trongTable_Listvàfdw_import_schema_exceptcó nghĩa là loại trừ kèo bóng đá pháp bảng được liệt kê trongTable_List.Tùy chọnlà danh sách kèo bóng đá pháp tùy chọn được sử dụng cho quy trình nhập. Ý nghĩa của kèo bóng đá pháp tùy chọn là tùy thuộc vào FDW.không nullthuộc tính của kèo bóng đá pháp cột phải được nhập. kèo bóng đá pháp tùy chọn này không cần phải làm gì với kèo bóng đá pháp 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 đá phápImportForignSchemastMT, 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 đá pháplệ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 đá pháp bảng được loại trừ theo kèo bóng đá pháp 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 đá pháp lệnh cho kèo bóng đá pháp bảng bị loại trừ ngay từ đầu.65622_65650Có thể hữu ích để kiểm tra xem một tên bàn nước kèo bóng đá pháp nhất định sẽ vượt qua bộ lọc.

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

AForeignScanNode, tùy chọn, hỗ trợ thực thi song song. Một song songForeignScansẽ đượ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 đá pháp quy trình hợp tác. Để làm điều này, kèo bóng đá pháp quá trình có thể phối hợp thông qua kèo bóng đá pháp 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 đá pháp 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 đá phápƯớ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 đá pháp sắp được kéo dài 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.RescanForignScanHàm 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 đá pháp 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 đá pháp 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ạoSmforignScan. 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 nguyên phát hành 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 đá pháp trường hợp;endforeignscanCó 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 đá pháp 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 đá pháp mối quan hệ con đã choChild_relđược tham số hóa bởi mối quan hệ con. Chức năng được sử dụng để sắp xếp kèo bóng đá pháp 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 đá pháp AForeignPath. Cuộc kèo bóng đá pháp 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.