github.com/m3db/m3@v1.5.1-0.20231129193456-75a402aa583b/src/dbnode/integration/client.go

// Copyright (c) 2016 Uber Technologies, Inc.
//
// Permission is hereby granted, free of charge, to any person obtaining a copy
// of this software and associated documentation files (the "Software"), to deal
// in the Software without restriction, including without limitation the rights
// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
// copies of the Software, and to permit persons to whom the Software is
// furnished to do so, subject to the following conditions:
//
// The above copyright notice and this permission notice shall be included in
// all copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
// THE SOFTWARE.

package integration

import (
	"errors"
	"sync"
	"time"

	"github.com/m3db/m3/src/dbnode/client"
	"github.com/m3db/m3/src/dbnode/generated/thrift/rpc"
	"github.com/m3db/m3/src/dbnode/integration/generate"
	nchannel "github.com/m3db/m3/src/dbnode/network/server/tchannelthrift/node/channel"
	"github.com/m3db/m3/src/dbnode/storage/block"
	"github.com/m3db/m3/src/dbnode/storage/bootstrap/result"
	"github.com/m3db/m3/src/dbnode/topology"
	"github.com/m3db/m3/src/x/checked"
	"github.com/m3db/m3/src/x/ident"
	xsync "github.com/m3db/m3/src/x/sync"
	xtime "github.com/m3db/m3/src/x/time"

	"github.com/uber/tchannel-go"
	"github.com/uber/tchannel-go/thrift"
)

// TestTChannelClient is a test only TChannel client that exposes db methods.
type TestTChannelClient struct {
	address string
	channel *tchannel.Channel
	name    string
	node    rpc.TChanNode
}

// NewTChannelClient creates a new client on the given address.
func NewTChannelClient(name, address string) (*TestTChannelClient, error) {
	channel, err := tchannel.NewChannel(name, nil)
	if err != nil {
		return &TestTChannelClient{}, err
	}

	endpoint := &thrift.ClientOptions{HostPort: address}
	thriftClient := thrift.NewClient(channel, nchannel.ChannelName, endpoint)
	client := rpc.NewTChanNodeClient(thriftClient)
	return &TestTChannelClient{
		name:    name,
		address: address,
		channel: channel,
		node:    client,
	}, nil
}

// Address returns the address.
func (client *TestTChannelClient) Address() string {
	return client.address
}

// Channel returns the TChannel channel.
func (client *TestTChannelClient) Channel() *tchannel.Channel {
	return client.channel
}

// TChannelClientWrite writes a datapoint using a tchannel client.
func (client *TestTChannelClient) TChannelClientWrite(
	timeout time.Duration, req *rpc.WriteRequest,
) error {
	ctx, _ := thrift.NewContext(timeout)
	return client.node.Write(ctx, req)
}

// TChannelClientWriteTagged writes a datapoint using a tchannel client.
func (client *TestTChannelClient) TChannelClientWriteTagged(
	timeout time.Duration, req *rpc.WriteTaggedRequest,
) error {
	ctx, _ := thrift.NewContext(timeout)
	return client.node.WriteTagged(ctx, req)
}

// TChannelClientWriteBatch writes a data map using a tchannel client.
func (client *TestTChannelClient) TChannelClientWriteBatch(
	timeout time.Duration, namespace ident.ID, seriesList generate.SeriesBlock,
) error {
	var elems []*rpc.WriteBatchRawRequestElement
	for _, series := range seriesList {
		for _, dp := range series.Data {
			elem := &rpc.WriteBatchRawRequestElement{
				ID: series.ID.Bytes(),
				Datapoint: &rpc.Datapoint{
					Timestamp:         dp.TimestampNanos.Seconds(),
					Value:             dp.Value,
					Annotation:        dp.Annotation,
					TimestampTimeType: rpc.TimeType_UNIX_SECONDS,
				},
			}
			elems = append(elems, elem)
		}
	}

	ctx, _ := thrift.NewContext(timeout)
	batchReq := &rpc.WriteBatchRawRequest{
		NameSpace: namespace.Bytes(),
		Elements:  elems,
	}
	return client.node.WriteBatchRaw(ctx, batchReq)
}

// TChannelClientWriteTaggedBatchRaw fulfills a wwrite tagged batch raw request
// using a tchannel client.
func (client *TestTChannelClient) TChannelClientWriteTaggedBatchRaw(
	timeout time.Duration, req *rpc.WriteTaggedBatchRawRequest,
) error {
	ctx, _ := thrift.NewContext(timeout)
	return client.node.WriteTaggedBatchRaw(ctx, req)
}

// TChannelClientFetch fulfills a fetch request using a tchannel client.
func (client *TestTChannelClient) TChannelClientFetch(
	timeout time.Duration, req *rpc.FetchRequest,
) (*rpc.FetchResult_, error) {
	ctx, _ := thrift.NewContext(timeout)
	return client.node.Fetch(ctx, req)
}

// TChannelClientFetchTagged fulfills a fetch by tag request using a tchannel client.
func (client *TestTChannelClient) TChannelClientFetchTagged(
	timeout time.Duration, req *rpc.FetchTaggedRequest,
) (*rpc.FetchTaggedResult_, error) {
	ctx, _ := thrift.NewContext(timeout)
	return client.node.FetchTagged(ctx, req)
}

// TChannelClientAggregateTiles runs a request for AggregateTiles.
func (client *TestTChannelClient) TChannelClientAggregateTiles(
	timeout time.Duration, req *rpc.AggregateTilesRequest,
) (*rpc.AggregateTilesResult_, error) {
	ctx, _ := thrift.NewContext(timeout)
	return client.node.AggregateTiles(ctx, req)
}

// TChannelClientTruncate fulfills a namespace truncation request using a tchannel client.
func (client *TestTChannelClient) TChannelClientTruncate(
	timeout time.Duration, req *rpc.TruncateRequest,
) (int64, error) {
	ctx, _ := thrift.NewContext(timeout)
	truncated, err := client.node.Truncate(ctx, req)
	if err != nil {
		return 0, err
	}
	return truncated.NumSeries, nil
}

// TChannelClientHealth fulfills a client health request using a tchannel client.
func (client *TestTChannelClient) TChannelClientHealth(
	timeout time.Duration,
) (*rpc.NodeHealthResult_, error) {
	ctx, _ := thrift.NewContext(timeout)
	return client.node.Health(ctx)
}

func m3dbAdminClient(opts client.AdminOptions) (client.AdminClient, error) {
	return client.NewAdminClient(opts)
}

// m3dbClientWriteBatch writes a data map using an m3db client.
func m3dbClientWriteBatch(client client.Client, workerPool xsync.WorkerPool, namespace ident.ID, seriesList generate.SeriesBlock) error {
	session, err := client.DefaultSession()
	if err != nil {
		return err
	}

	var (
		errCh = make(chan error, 1)
		wg    sync.WaitGroup
	)

	for _, series := range seriesList {
		for _, dp := range series.Data {
			wg.Add(1)
			id, d := series.ID, dp
			workerPool.Go(func() {
				defer wg.Done()

				if err := session.Write(
					namespace, id, d.TimestampNanos, d.Value, xtime.Second, d.Annotation,
				); err != nil {
					select {
					case errCh <- err:
					default:
					}
				}
			})
		}
	}

	wg.Wait()
	close(errCh)

	return <-errCh
}

// m3dbClientFetch fulfills a fetch request using an m3db client.
func m3dbClientFetch(client client.Client, req *rpc.FetchRequest) ([]generate.TestValue, error) {
	session, err := client.DefaultSession()
	if err != nil {
		return nil, err
	}

	iter, err := session.Fetch(
		ident.StringID(req.NameSpace),
		ident.StringID(req.ID),
		xtime.FromNormalizedTime(req.RangeStart, time.Second),
		xtime.FromNormalizedTime(req.RangeEnd, time.Second),
	)
	if err != nil {
		return nil, err
	}

	defer iter.Close()

	var datapoints []generate.TestValue
	for iter.Next() {
		dp, _, annotation := iter.Current()
		datapoints = append(datapoints, generate.TestValue{Datapoint: dp, Annotation: annotation})
	}
	if err := iter.Err(); err != nil {
		return nil, err
	}
	return datapoints, nil
}

// m3dbClientTruncate fulfills a truncation request using an m3db client.
func m3dbClientTruncate(c client.Client, req *rpc.TruncateRequest) (int64, error) {
	session, err := c.DefaultSession()
	if err != nil {
		return 0, err
	}

	adminSession, ok := session.(client.AdminSession)
	if !ok {
		return 0, errors.New("unable to get an admin session")
	}

	return adminSession.Truncate(ident.BinaryID(checked.NewBytes(req.NameSpace, nil)))
}

func m3dbClientFetchBlocksMetadata(
	c client.AdminClient,
	namespace ident.ID,
	shards []uint32,
	start, end xtime.UnixNano,
	consistencyLevel topology.ReadConsistencyLevel,
) (map[uint32][]block.ReplicaMetadata, error) {
	session, err := c.DefaultAdminSession()
	if err != nil {
		return nil, err
	}

	metadatasByShard := make(map[uint32][]block.ReplicaMetadata, 10)

	// iterate over all shards
	seen := make(map[string]map[xtime.UnixNano]struct{})
	for _, shardID := range shards {
		// clear seen
		for key := range seen {
			delete(seen, key)
		}

		var metadatas []block.ReplicaMetadata
		iter, err := session.FetchBlocksMetadataFromPeers(namespace,
			shardID, start, end, consistencyLevel, result.NewOptions())
		if err != nil {
			return nil, err
		}

		for iter.Next() {
			host, blockMetadata := iter.Current()
			idString := blockMetadata.ID.String()
			seenBlocks, ok := seen[idString]
			if !ok {
				seenBlocks = make(map[xtime.UnixNano]struct{})
				seen[idString] = seenBlocks
			}
			if _, ok := seenBlocks[blockMetadata.Start]; ok {
				continue // Already seen
			}
			seenBlocks[blockMetadata.Start] = struct{}{}
			metadatas = append(metadatas, block.ReplicaMetadata{
				Metadata: blockMetadata,
				Host:     host,
			})
		}
		if err := iter.Err(); err != nil {
			return nil, err
		}

		if metadatas != nil {
			metadatasByShard[shardID] = metadatas
		}
	}

	return metadatasByShard, nil
}