ลองRpc

ดำเนินการคำขอ RPC เป็นชุด

การดำเนินการนี้ดำเนินการคำขอ RPC เดียวหรือชุดคำขอแบบอะซิงโครนัส คำขอ RPC ถูกกำหนดโดยพารามิเตอร์หลักสามตัว:

- `address` (โฮสต์+พอร์ตหรือที่อยู่ BNS ของคำขอ) - `method` (ชื่อวิธีการสำหรับคำขอ) - `request` (สตริงโปรโตแบบอนุกรมหรือเวกเตอร์ของสตริงของอาร์กิวเมนต์คำขอ RPC)

ตัวอย่างเช่น หากคุณมีบริการ RPC ที่ทำงานบนพอร์ต localhost:2345 และอินเทอร์เฟซได้รับการกำหนดค่าด้วยการประกาศโปรโตต่อไปนี้:

service MyService {
   rpc MyMethod(MyRequestProto) returns (MyResponseProto) {
   
 };
 }

จากนั้นเรียก op นี้พร้อมกับอาร์กิวเมนต์:

address = "localhost:2345"
 method = "MyService/MyMethod"
 

เทนเซอร์ `คำขอ` คือเทนเซอร์สตริงที่แสดงถึง สตริง `MyRequestProto` ที่ต่อเนื่องกัน และเทนเซอร์สตริงเอาท์พุต `response` จะมีรูปร่างเหมือนกันและมี (เมื่อเสร็จสิ้นสำเร็จ) สตริง `MyResponseProto` ที่เป็นอนุกรมที่สอดคล้องกัน

ตัวอย่างเช่น หากต้องการส่ง `MyRequestProto` ที่ว่างเปล่า ให้เรียก op นี้ด้วย `request = ""` หากต้องการส่งคำขอว่าง แบบขนาน 5 รายการ ให้เรียก op นี้ด้วย `request = ["", "", "", "", ""]`

โดยทั่วไป เราสามารถสร้างชุดของโปรโตอนุกรม `MyRequestProto` จากเทนเซอร์แบบแบตช์ปกติโดยใช้ op `encode_proto` และแปลงการตอบสนอง `MyResponseProto` โปรโตซีเรียลไลซ์เป็นเทนเซอร์แบบแบตช์โดยใช้ op `decode_proto`

หมายเหตุ การทำงานกับสตริงโปรโตแบบอนุกรมจะเร็วกว่าการสร้างอินสแตนซ์ออบเจ็กต์โปรโตจริงในหน่วยความจำ ดังนั้นจึงคาดว่าจะไม่ลดประสิทธิภาพลงเมื่อเปรียบเทียบกับการเขียนเคอร์เนลแบบกำหนดเองสำหรับเวิร์กโฟลว์นี้

ไม่เหมือนกับ op `Rpc` มาตรฐาน หากการเชื่อมต่อล้มเหลวหรือผู้ปฏิบัติงานระยะไกลส่งคืนสถานะข้อผิดพลาด op นี้ ไม่ ทำให้เกิดข้อยกเว้นอีกครั้ง แต่รายการ `status_code` และ `status_message` สำหรับการเรียก RPC ที่เกี่ยวข้องจะถูกตั้งค่าโดยมีข้อผิดพลาดที่ส่งคืนจากการเรียก RPC เทนเซอร์ "การตอบสนอง" จะมีค่าการตอบสนองที่ถูกต้องสำหรับรายการมินิแบทช์ที่ RPC ไม่ล้มเหลว รายการที่เหลือจะมีสตริงว่าง