syncpointStore.go

// Copyright 2020 PingCAP, Inc.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// See the License for the specific language governing permissions and
// limitations under the License.

package sink

import (
	"context"
	"net/url"
	"strings"

	"github.com/pingcap/ticdc/cdc/model"
	cerror "github.com/pingcap/ticdc/pkg/errors"
)

// SyncpointStore is an abstraction for anything that a changefeed may emit into.
type SyncpointStore interface {
	// CreateSynctable create a table to record the syncpoints
	CreateSynctable(ctx context.Context) error

	// SinkSyncpoint record the syncpoint(a map with ts) in downstream db
	SinkSyncpoint(ctx context.Context, id string, checkpointTs uint64) error

	// Close closes the SyncpointSink
	Close() error
}

// NewSyncpointStore creates a new Spyncpoint sink with the sink-uri
func NewSyncpointStore(ctx context.Context, changefeedID model.ChangeFeedID, sinkURIStr string) (SyncpointStore, error) {
	// parse sinkURI as a URI
	sinkURI, err := url.Parse(sinkURIStr)
	if err != nil {
		return nil, cerror.WrapError(cerror.ErrSinkURIInvalid, err)
	}
	switch strings.ToLower(sinkURI.Scheme) {
	case "mysql", "tidb", "mysql+ssl", "tidb+ssl":
		return newMySQLSyncpointStore(ctx, changefeedID, sinkURI)
	default:
		return nil, cerror.ErrSinkURIInvalid.GenWithStack("the sink scheme (%s) is not supported", sinkURI.Scheme)
	}
}