Documentation
¶
Overview ¶
Package sink provides a typed, concurrency-safe Go client for the Sink gRPC service.
Index ¶
- Constants
- func DeleteResultsError(results []DeleteResult) error
- func ReadResultsError(results []ReadResult) error
- func WriteResultsError(results []WriteResult) error
- type Address
- type BatchError
- type Client
- func (c *Client) CheckHealth(ctx context.Context) error
- func (c *Client) Close() error
- func (c *Client) Delete(ctx context.Context, completionMode CompletionMode, addresses ...Address) ([]DeleteResult, error)
- func (c *Client) DeleteAll(ctx context.Context, completionMode CompletionMode, addresses []Address) ([]DeleteResult, error)
- func (c *Client) Raw() sinkv1.SinkClient
- func (c *Client) Read(ctx context.Context, addresses ...Address) ([]ReadResult, error)
- func (c *Client) ReadAll(ctx context.Context, addresses []Address) ([]ReadResult, error)
- func (c *Client) Write(ctx context.Context, completionMode CompletionMode, ...) ([]WriteResult, error)
- func (c *Client) WriteAll(ctx context.Context, completionMode CompletionMode, ...) ([]WriteResult, error)
- type ClientOptions
- type CompletionMode
- type DeleteResult
- type DeleteStatus
- type DialOptions
- type Document
- type FailureCode
- type Key
- type MergeOptions
- type MergeProfile
- type MissingDocumentMode
- type OperationError
- type ProtocolError
- type ReadResult
- type ReadStatus
- type RetryPolicy
- type RevisionToken
- type WriteMode
- type WriteOperation
- type WriteResult
- type WriteStatus
Constants ¶
const ( ContentTypeBSON = "application/bson" ContentTypeJSON = "application/json" )
Variables ¶
This section is empty.
Functions ¶
func DeleteResultsError ¶
func DeleteResultsError(results []DeleteResult) error
func ReadResultsError ¶
func ReadResultsError(results []ReadResult) error
func WriteResultsError ¶
func WriteResultsError(results []WriteResult) error
Types ¶
type Address ¶
type Address struct {
// contains filtered or unexported fields
}
Address identifies a record through logical names rather than physical database terminology.
func NewAddress ¶
type BatchError ¶
type BatchError struct {
Failures []*OperationError
}
BatchError collects per-operation failures while preserving errors.Is and errors.As traversal through every failure.
func (*BatchError) Error ¶
func (e *BatchError) Error() string
func (*BatchError) Unwrap ¶
func (e *BatchError) Unwrap() []error
type Client ¶
type Client struct {
// contains filtered or unexported fields
}
Client is safe for concurrent use.
func Dial ¶
func Dial(target string, opts DialOptions) (*Client, error)
Dial creates a lazily connected gRPC client. Call CheckHealth when startup must prove the endpoint is reachable before processing work.
func New ¶
func New(connection grpc.ClientConnInterface, opts ClientOptions) (*Client, error)
New wraps an existing connection without taking ownership of it.
func (*Client) CheckHealth ¶
CheckHealth verifies that the server's standard gRPC health service reports SERVING.
func (*Client) Close ¶
Close closes connections created by Dial. It is a no-op for clients created with New because the caller owns that connection.
func (*Client) Delete ¶
func (c *Client) Delete( ctx context.Context, completionMode CompletionMode, addresses ...Address, ) ([]DeleteResult, error)
Delete permanently deletes records. Deleting an absent record is successful. Transport failures are not retried automatically.
func (*Client) DeleteAll ¶
func (c *Client) DeleteAll( ctx context.Context, completionMode CompletionMode, addresses []Address, ) ([]DeleteResult, error)
DeleteAll splits a larger collection into configured operation-count batches. Earlier batches may have completed when a later batch returns an RPC error.
func (*Client) Raw ¶
func (c *Client) Raw() sinkv1.SinkClient
Raw returns the generated gRPC client for advanced or forward-compatible usage.
func (*Client) Read ¶
Read returns results in request order. Transport-level Unavailable errors and retryable per-operation failures are retried, because reads are idempotent.
func (*Client) ReadAll ¶
ReadAll splits a larger collection into configured operation-count batches. Returned operation indexes refer to the original collection.
func (*Client) Write ¶
func (c *Client) Write( ctx context.Context, completionMode CompletionMode, operations ...WriteOperation, ) ([]WriteResult, error)
Write submits a mixed batch of put and merge operations. It deliberately does not retry transport failures because the server may already have applied or durably accepted the mutation.
func (*Client) WriteAll ¶
func (c *Client) WriteAll( ctx context.Context, completionMode CompletionMode, operations []WriteOperation, ) ([]WriteResult, error)
WriteAll splits a larger collection into configured operation-count batches. Earlier batches may have completed when a later batch returns an RPC error.
type ClientOptions ¶
type ClientOptions struct {
MaxOperations int
ReadRetry RetryPolicy
MaxReceiveMessageBytes int
MaxSendMessageBytes int
}
ClientOptions controls request limits and safe read retries.
type CompletionMode ¶
type CompletionMode = sinkv1.CompletionMode
const ( CompletionWaitUntilApplied CompletionMode = sinkv1.CompletionMode_COMPLETION_MODE_WAIT_UNTIL_APPLIED CompletionReturnAfterAccepted CompletionMode = sinkv1.CompletionMode_COMPLETION_MODE_RETURN_AFTER_ACCEPTED )
type DeleteResult ¶
type DeleteResult struct {
OperationIndex int
Status DeleteStatus
Failure *OperationError
}
func (DeleteResult) Err ¶
func (r DeleteResult) Err() error
type DeleteStatus ¶
type DeleteStatus = sinkv1.DeleteStatus
const ( DeleteAccepted DeleteStatus = sinkv1.DeleteStatus_DELETE_STATUS_ACCEPTED DeleteApplied DeleteStatus = sinkv1.DeleteStatus_DELETE_STATUS_APPLIED DeleteFailed DeleteStatus = sinkv1.DeleteStatus_DELETE_STATUS_FAILED )
type DialOptions ¶
type DialOptions struct {
Client ClientOptions
TransportCredentials credentials.TransportCredentials
GRPCOptions []grpc.DialOption
}
DialOptions controls connection creation. TLS with a minimum version of 1.2 is used when TransportCredentials is nil. Use insecure.NewCredentials only for a trusted plaintext development endpoint.
type Document ¶
type Document struct {
// contains filtered or unexported fields
}
Document contains content-type-labelled, lossless bytes. NewDocument copies data so later caller mutation cannot change an in-flight operation.
func JSONDocument ¶
func (Document) ContentType ¶
func (Document) DecodeJSON ¶
type FailureCode ¶
type FailureCode = sinkv1.FailureCode
const ( FailureInvalidArgument FailureCode = sinkv1.FailureCode_FAILURE_CODE_INVALID_ARGUMENT FailurePreconditionFailed FailureCode = sinkv1.FailureCode_FAILURE_CODE_PRECONDITION_FAILED FailureNotFound FailureCode = sinkv1.FailureCode_FAILURE_CODE_NOT_FOUND FailureConflict FailureCode = sinkv1.FailureCode_FAILURE_CODE_CONFLICT FailureResourceExhausted FailureCode = sinkv1.FailureCode_FAILURE_CODE_RESOURCE_EXHAUSTED FailureDeadlineExceeded FailureCode = sinkv1.FailureCode_FAILURE_CODE_DEADLINE_EXCEEDED FailureInternal FailureCode = sinkv1.FailureCode_FAILURE_CODE_INTERNAL )
type Key ¶
type Key struct {
// contains filtered or unexported fields
}
Key is an immutable logical record key. Use one of the key constructors.
type MergeOptions ¶
type MergeOptions struct {
IncomingDocument Document
Profile MergeProfile
MissingDocumentMode MissingDocumentMode
}
MergeOptions describes a profile-driven read-modify-write operation.
type MergeProfile ¶
type MergeProfile struct {
// contains filtered or unexported fields
}
MergeProfile selects a server-side merge implementation and version.
func NewMergeProfile ¶
func NewMergeProfile(name string, version uint64) (MergeProfile, error)
type MissingDocumentMode ¶
type MissingDocumentMode = sinkv1.MissingDocumentMode
const ( MissingDocumentFail MissingDocumentMode = sinkv1.MissingDocumentMode_MISSING_DOCUMENT_MODE_FAIL MissingDocumentCreate MissingDocumentMode = sinkv1.MissingDocumentMode_MISSING_DOCUMENT_MODE_CREATE )
type OperationError ¶
type OperationError struct {
OperationIndex int
Code FailureCode
Message string
Retryable bool
}
OperationError reports a per-record failure without discarding successful results from the same batch.
func (*OperationError) Error ¶
func (e *OperationError) Error() string
type ProtocolError ¶
ProtocolError means the server returned a structurally invalid response.
func (*ProtocolError) Error ¶
func (e *ProtocolError) Error() string
type ReadResult ¶
type ReadResult struct {
OperationIndex int
Status ReadStatus
Document Document
Revision RevisionToken
Failure *OperationError
}
func (ReadResult) Err ¶
func (r ReadResult) Err() error
type ReadStatus ¶
type ReadStatus = sinkv1.ReadStatus
const ( ReadFound ReadStatus = sinkv1.ReadStatus_READ_STATUS_FOUND ReadNotFound ReadStatus = sinkv1.ReadStatus_READ_STATUS_NOT_FOUND ReadFailed ReadStatus = sinkv1.ReadStatus_READ_STATUS_FAILED )
type RetryPolicy ¶
type RetryPolicy struct {
MaxAttempts int
InitialBackoff time.Duration
MaxBackoff time.Duration
Multiplier float64
Jitter float64
}
RetryPolicy controls retries for transport-level Unavailable errors and retryable per-operation failures from Read. Mutating RPCs are never retried automatically.
type RevisionToken ¶
type RevisionToken struct {
// contains filtered or unexported fields
}
RevisionToken is an opaque storage revision returned by Sink.
func (RevisionToken) Bytes ¶
func (r RevisionToken) Bytes() []byte
type WriteMode ¶
const ( WriteCreate WriteMode = sinkv1.WriteMode_WRITE_MODE_CREATE WriteReplace WriteMode = sinkv1.WriteMode_WRITE_MODE_REPLACE WriteUpsert WriteMode = sinkv1.WriteMode_WRITE_MODE_UPSERT )
type WriteOperation ¶
type WriteOperation struct {
// contains filtered or unexported fields
}
WriteOperation is either a put or merge operation. Use NewPut or NewMerge.
func NewMerge ¶
func NewMerge(address Address, opts MergeOptions) (WriteOperation, error)
type WriteResult ¶
type WriteResult struct {
OperationIndex int
Status WriteStatus
Revision RevisionToken
Failure *OperationError
}
func (WriteResult) Err ¶
func (r WriteResult) Err() error
type WriteStatus ¶
type WriteStatus = sinkv1.WriteStatus
const ( WriteAccepted WriteStatus = sinkv1.WriteStatus_WRITE_STATUS_ACCEPTED WriteApplied WriteStatus = sinkv1.WriteStatus_WRITE_STATUS_APPLIED WritePreconditionFailed WriteStatus = sinkv1.WriteStatus_WRITE_STATUS_PRECONDITION_FAILED WriteFailed WriteStatus = sinkv1.WriteStatus_WRITE_STATUS_FAILED )