In this article
Overview
You can use this Snap to interact with a gRPC (Google Remote Procedure Call) server to invoke its services. gRPC is a high-performance, open-source framework developed by Google that uses protocol buffers (Protobuf) as its interface definition language (IDL) to define the structure of the service and the messages exchanged between the client and server. Learn more.
Snap Type
The gRPC Client Snap is a Read-type Snap that reads
Prerequisites
grpcurl to interact with gRPC servers.
A valid account with the required permissions.
Support for Ultra Pipelines
Works in Ultra Tasks.
Limitations
None.
Known Issues
None.
Snap Views
Type | Format | Number of Views | Examples of Upstream and Downstream Snaps | Description |
---|---|---|---|---|
Input | Document |
|
| The snap requires the user to input a gRPC server endpoint to connect to, and then select the specific service and method to access. |
Output | Document |
|
| |
Error | Error handling is a generic way to handle errors without losing data or failing the Snap execution. You can handle the errors that the Snap might encounter when running the pipeline by choosing one of the following options from the When errors occur list under the Views tab:
Learn more about Error handling in Pipelines. |
Snap Settings
Expression : Indicates the value is an expression (if enabled) or a static value (if disabled). Learn more about Using Expressions in SnapLogic.
Suggestion : Populates a list of values dynamically based on your Account configuration.
Upload : Uploads files. Learn more.
Learn more about the icons in the Snap Settings dialog.
Field Name | Field Type | Description |
---|---|---|
Label* Default Value: gRPC Client | String | Specify the name for the Snap. You can modify this to be more specific, especially if you have more than one of the same Snap in your pipeline. |
Server endpoint Default Value: N/A | String/Expression | Specify the server to which the requests are sent. |
gRPC service
| String/Expression/Suggestion | Specify the gRPC request to be made. |
gRPC method
| String/Expression/Suggestion | Specify the gRPC method request. |
Snap Execution Default Value: | Dropdown list | Select one of the following three modes in which the Snap executes:
|
Troubleshooting
Error | Reason | Resolution |
---|---|---|
Account validation failed. | The Pipeline ended before the batch could complete execution due to a connection error. | Verify that the Refresh token field is configured to handle the inputs properly. If you are not sure when the input data is available, configure this field as zero to keep the connection always open. |
Examples
Excluding Fields from the Input Data Stream
We can exclude the unrequired fields from the input data stream by omitting them in the Input schema fieldset. This example demonstrates how we can use the <Snap Name> to achieve this result:
<screenshot of Pipeline/Snap and description>
Download this Pipeline.
Downloads
Download and import the pipeline into the SnapLogic application.
Configure Snap accounts, as applicable.
Provide pipeline parameters, as applicable.
Snap Pack History
Related Content
Endpoint Doc Link 1