feat: Add IsPaid flag to table definition (#1327)

This adds an `IsPaid` flag to the table definition. This can be used by premium plugins to indicate that a certain table is paid.

Author: hermanschaaf

schema/arrow.go

@@ -16,6 +16,7 @@ const (
 	MetadataTableDescription = "cq:table_description"
 	MetadataTableTitle       = "cq:table_title"
 	MetadataTableDependsOn   = "cq:table_depends_on"
+	MetadataTableIsPaid      = "cq:table_paid"
 )
 
 type Schemas []*arrow.Schema

schema/table.go

@@ -87,6 +87,11 @@ type Table struct {
 	Parent *Table `json:"-"`
 
 	PkConstraintName string `json:"pk_constraint_name"`
+
+	// IsPaid indicates whether this table is a paid (premium) table.
+	// This relates to the CloudQuery plugin itself, and should not be confused
+	// with whether the table makes use of a paid API or not.
+	IsPaid bool `json:"is_paid"`
 }
 
 var (
@@ -158,6 +163,9 @@ func NewTableFromArrowSchema(sc *arrow.Schema) (*Table, error) {
 	if isIncremental, found := tableMD.GetValue(MetadataIncremental); found {
 		table.IsIncremental = isIncremental == MetadataTrue
 	}
+	if isPaid, found := tableMD.GetValue(MetadataTableIsPaid); found {
+		table.IsPaid = isPaid == MetadataTrue
+	}
 	return table, nil
 }
 
@@ -407,6 +415,9 @@ func (t *Table) ToArrowSchema() *arrow.Schema {
 	if t.Parent != nil {
 		md[MetadataTableDependsOn] = t.Parent.Name
 	}
+	if t.IsPaid {
+		md[MetadataTableIsPaid] = MetadataTrue
+	}
 	schemaMd := arrow.MetadataFrom(md)
 	for i, c := range t.Columns {
 		fields[i] = c.ToArrowField()