Module org.apache.arrow.flight.core
Package org.apache.arrow.flight.sql.impl

Class FlightSql.CommandGetTables.Builder

java.lang.Object
com.google.protobuf.AbstractMessageLite.Builder
com.google.protobuf.AbstractMessage.Builder<BuilderT>
com.google.protobuf.GeneratedMessage.Builder<FlightSql.CommandGetTables.Builder>
org.apache.arrow.flight.sql.impl.FlightSql.CommandGetTables.Builder
All Implemented Interfaces:
com.google.protobuf.Message.Builder, com.google.protobuf.MessageLite.Builder, com.google.protobuf.MessageLiteOrBuilder, com.google.protobuf.MessageOrBuilder, Cloneable, FlightSql.CommandGetTablesOrBuilder
Enclosing class:
FlightSql.CommandGetTables
public static final class FlightSql.CommandGetTables.Builder extends com.google.protobuf.GeneratedMessage.Builder<FlightSql.CommandGetTables.Builder> implements FlightSql.CommandGetTablesOrBuilder

 Represents a request to retrieve the list of tables, and optionally their schemas, on a Flight SQL enabled backend.
 Used in the command member of FlightDescriptor for the following RPC calls:
 - GetSchema: return the Arrow schema of the query.
 - GetFlightInfo: execute the catalog metadata request.

 The returned Arrow schema will be:
 <
 catalog_name: utf8,
 db_schema_name: utf8,
 table_name: utf8 not null,
 table_type: utf8 not null,
 [optional] table_schema: bytes not null (schema of the table as described in Schema.fbs::Schema,
 it is serialized as an IPC message.)
 >
 Fields on table_schema may contain the following metadata:
 - ARROW:FLIGHT:SQL:CATALOG_NAME      - Table's catalog name
 - ARROW:FLIGHT:SQL:DB_SCHEMA_NAME    - Database schema name
 - ARROW:FLIGHT:SQL:TABLE_NAME        - Table name
 - ARROW:FLIGHT:SQL:TYPE_NAME         - The data source-specific name for the data type of the column.
 - ARROW:FLIGHT:SQL:PRECISION         - Column precision/size
 - ARROW:FLIGHT:SQL:SCALE             - Column scale/decimal digits if applicable
 - ARROW:FLIGHT:SQL:IS_AUTO_INCREMENT - "1" indicates if the column is auto incremented, "0" otherwise.
 - ARROW:FLIGHT:SQL:IS_CASE_SENSITIVE - "1" indicates if the column is case-sensitive, "0" otherwise.
 - ARROW:FLIGHT:SQL:IS_READ_ONLY      - "1" indicates if the column is read only, "0" otherwise.
 - ARROW:FLIGHT:SQL:IS_SEARCHABLE     - "1" indicates if the column is searchable via WHERE clause, "0" otherwise.
 - ARROW:FLIGHT:SQL:REMARKS           - A comment describing the column.
 The returned data should be ordered by catalog_name, db_schema_name, table_name, then table_type, followed by table_schema if requested.
Protobuf type arrow.flight.protocol.sql.CommandGetTables

  • Method Details

    • getDescriptor

      public static final com.google.protobuf.Descriptors.Descriptor getDescriptor()

    • internalGetFieldAccessorTable

      protected com.google.protobuf.GeneratedMessage.FieldAccessorTable internalGetFieldAccessorTable()
      Specified by:
      internalGetFieldAccessorTable in class com.google.protobuf.GeneratedMessage.Builder<FlightSql.CommandGetTables.Builder>

    • clear

      public FlightSql.CommandGetTables.Builder clear()
      Specified by:
      clear in interface com.google.protobuf.Message.Builder
      Specified by:
      clear in interface com.google.protobuf.MessageLite.Builder
      Overrides:
      clear in class com.google.protobuf.GeneratedMessage.Builder<FlightSql.CommandGetTables.Builder>

    • getDescriptorForType

      public com.google.protobuf.Descriptors.Descriptor getDescriptorForType()
      Specified by:
      getDescriptorForType in interface com.google.protobuf.Message.Builder
      Specified by:
      getDescriptorForType in interface com.google.protobuf.MessageOrBuilder
      Overrides:
      getDescriptorForType in class com.google.protobuf.GeneratedMessage.Builder<FlightSql.CommandGetTables.Builder>

    • getDefaultInstanceForType

      public FlightSql.CommandGetTables getDefaultInstanceForType()
      Specified by:
      getDefaultInstanceForType in interface com.google.protobuf.MessageLiteOrBuilder
      Specified by:
      getDefaultInstanceForType in interface com.google.protobuf.MessageOrBuilder

    • build

      public FlightSql.CommandGetTables build()
      Specified by:
      build in interface com.google.protobuf.Message.Builder
      Specified by:
      build in interface com.google.protobuf.MessageLite.Builder

    • buildPartial

      public FlightSql.CommandGetTables buildPartial()
      Specified by:
      buildPartial in interface com.google.protobuf.Message.Builder
      Specified by:
      buildPartial in interface com.google.protobuf.MessageLite.Builder

    • mergeFrom

      public FlightSql.CommandGetTables.Builder mergeFrom(com.google.protobuf.Message other)
      Specified by:
      mergeFrom in interface com.google.protobuf.Message.Builder
      Overrides:
      mergeFrom in class com.google.protobuf.AbstractMessage.Builder<FlightSql.CommandGetTables.Builder>

    • mergeFrom

      public FlightSql.CommandGetTables.Builder mergeFrom(FlightSql.CommandGetTables other)

    • isInitialized

      public final boolean isInitialized()
      Specified by:
      isInitialized in interface com.google.protobuf.MessageLiteOrBuilder
      Overrides:
      isInitialized in class com.google.protobuf.GeneratedMessage.Builder<FlightSql.CommandGetTables.Builder>

    • mergeFrom

      public FlightSql.CommandGetTables.Builder mergeFrom(com.google.protobuf.CodedInputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry) throws IOException
      Specified by:
      mergeFrom in interface com.google.protobuf.Message.Builder
      Specified by:
      mergeFrom in interface com.google.protobuf.MessageLite.Builder
      Overrides:
      mergeFrom in class com.google.protobuf.AbstractMessage.Builder<FlightSql.CommandGetTables.Builder>
      Throws:
      IOException

    • hasCatalog

      public boolean hasCatalog()
      
 Specifies the Catalog to search for the tables.
 An empty string retrieves those without a catalog.
 If omitted the catalog name should not be used to narrow the search.
      optional string catalog = 1;
      Specified by:
      hasCatalog in interface FlightSql.CommandGetTablesOrBuilder
      Returns:
      Whether the catalog field is set.

    • getCatalog

      public String getCatalog()
      
 Specifies the Catalog to search for the tables.
 An empty string retrieves those without a catalog.
 If omitted the catalog name should not be used to narrow the search.
      optional string catalog = 1;
      Specified by:
      getCatalog in interface FlightSql.CommandGetTablesOrBuilder
      Returns:
      The catalog.

    • getCatalogBytes

      public com.google.protobuf.ByteString getCatalogBytes()
      
 Specifies the Catalog to search for the tables.
 An empty string retrieves those without a catalog.
 If omitted the catalog name should not be used to narrow the search.
      optional string catalog = 1;
      Specified by:
      getCatalogBytes in interface FlightSql.CommandGetTablesOrBuilder
      Returns:
      The bytes for catalog.

    • setCatalog

      public FlightSql.CommandGetTables.Builder setCatalog(String value)
      
 Specifies the Catalog to search for the tables.
 An empty string retrieves those without a catalog.
 If omitted the catalog name should not be used to narrow the search.
      optional string catalog = 1;
      Parameters:
      value - The catalog to set.
      Returns:
      This builder for chaining.

    • clearCatalog

      public FlightSql.CommandGetTables.Builder clearCatalog()
      
 Specifies the Catalog to search for the tables.
 An empty string retrieves those without a catalog.
 If omitted the catalog name should not be used to narrow the search.
      optional string catalog = 1;
      Returns:
      This builder for chaining.

    • setCatalogBytes

      public FlightSql.CommandGetTables.Builder setCatalogBytes(com.google.protobuf.ByteString value)
      
 Specifies the Catalog to search for the tables.
 An empty string retrieves those without a catalog.
 If omitted the catalog name should not be used to narrow the search.
      optional string catalog = 1;
      Parameters:
      value - The bytes for catalog to set.
      Returns:
      This builder for chaining.

    • hasDbSchemaFilterPattern

      public boolean hasDbSchemaFilterPattern()
      
 Specifies a filter pattern for schemas to search for.
 When no db_schema_filter_pattern is provided, all schemas matching other filters are searched.
 In the pattern string, two special characters can be used to denote matching rules:
 - "%" means to match any substring with 0 or more characters.
 - "_" means to match any one character.
      optional string db_schema_filter_pattern = 2;
      Specified by:
      hasDbSchemaFilterPattern in interface FlightSql.CommandGetTablesOrBuilder
      Returns:
      Whether the dbSchemaFilterPattern field is set.

    • getDbSchemaFilterPattern

      public String getDbSchemaFilterPattern()
      
 Specifies a filter pattern for schemas to search for.
 When no db_schema_filter_pattern is provided, all schemas matching other filters are searched.
 In the pattern string, two special characters can be used to denote matching rules:
 - "%" means to match any substring with 0 or more characters.
 - "_" means to match any one character.
      optional string db_schema_filter_pattern = 2;
      Specified by:
      getDbSchemaFilterPattern in interface FlightSql.CommandGetTablesOrBuilder
      Returns:
      The dbSchemaFilterPattern.

    • getDbSchemaFilterPatternBytes

      public com.google.protobuf.ByteString getDbSchemaFilterPatternBytes()
      
 Specifies a filter pattern for schemas to search for.
 When no db_schema_filter_pattern is provided, all schemas matching other filters are searched.
 In the pattern string, two special characters can be used to denote matching rules:
 - "%" means to match any substring with 0 or more characters.
 - "_" means to match any one character.
      optional string db_schema_filter_pattern = 2;
      Specified by:
      getDbSchemaFilterPatternBytes in interface FlightSql.CommandGetTablesOrBuilder
      Returns:
      The bytes for dbSchemaFilterPattern.

    • setDbSchemaFilterPattern

      public FlightSql.CommandGetTables.Builder setDbSchemaFilterPattern(String value)
      
 Specifies a filter pattern for schemas to search for.
 When no db_schema_filter_pattern is provided, all schemas matching other filters are searched.
 In the pattern string, two special characters can be used to denote matching rules:
 - "%" means to match any substring with 0 or more characters.
 - "_" means to match any one character.
      optional string db_schema_filter_pattern = 2;
      Parameters:
      value - The dbSchemaFilterPattern to set.
      Returns:
      This builder for chaining.

    • clearDbSchemaFilterPattern

      public FlightSql.CommandGetTables.Builder clearDbSchemaFilterPattern()
      
 Specifies a filter pattern for schemas to search for.
 When no db_schema_filter_pattern is provided, all schemas matching other filters are searched.
 In the pattern string, two special characters can be used to denote matching rules:
 - "%" means to match any substring with 0 or more characters.
 - "_" means to match any one character.
      optional string db_schema_filter_pattern = 2;
      Returns:
      This builder for chaining.

    • setDbSchemaFilterPatternBytes

      public FlightSql.CommandGetTables.Builder setDbSchemaFilterPatternBytes(com.google.protobuf.ByteString value)
      
 Specifies a filter pattern for schemas to search for.
 When no db_schema_filter_pattern is provided, all schemas matching other filters are searched.
 In the pattern string, two special characters can be used to denote matching rules:
 - "%" means to match any substring with 0 or more characters.
 - "_" means to match any one character.
      optional string db_schema_filter_pattern = 2;
      Parameters:
      value - The bytes for dbSchemaFilterPattern to set.
      Returns:
      This builder for chaining.

    • hasTableNameFilterPattern

      public boolean hasTableNameFilterPattern()
      
 Specifies a filter pattern for tables to search for.
 When no table_name_filter_pattern is provided, all tables matching other filters are searched.
 In the pattern string, two special characters can be used to denote matching rules:
 - "%" means to match any substring with 0 or more characters.
 - "_" means to match any one character.
      optional string table_name_filter_pattern = 3;
      Specified by:
      hasTableNameFilterPattern in interface FlightSql.CommandGetTablesOrBuilder
      Returns:
      Whether the tableNameFilterPattern field is set.

    • getTableNameFilterPattern

      public String getTableNameFilterPattern()
      
 Specifies a filter pattern for tables to search for.
 When no table_name_filter_pattern is provided, all tables matching other filters are searched.
 In the pattern string, two special characters can be used to denote matching rules:
 - "%" means to match any substring with 0 or more characters.
 - "_" means to match any one character.
      optional string table_name_filter_pattern = 3;
      Specified by:
      getTableNameFilterPattern in interface FlightSql.CommandGetTablesOrBuilder
      Returns:
      The tableNameFilterPattern.

    • getTableNameFilterPatternBytes

      public com.google.protobuf.ByteString getTableNameFilterPatternBytes()
      
 Specifies a filter pattern for tables to search for.
 When no table_name_filter_pattern is provided, all tables matching other filters are searched.
 In the pattern string, two special characters can be used to denote matching rules:
 - "%" means to match any substring with 0 or more characters.
 - "_" means to match any one character.
      optional string table_name_filter_pattern = 3;
      Specified by:
      getTableNameFilterPatternBytes in interface FlightSql.CommandGetTablesOrBuilder
      Returns:
      The bytes for tableNameFilterPattern.

    • setTableNameFilterPattern

      public FlightSql.CommandGetTables.Builder setTableNameFilterPattern(String value)
      
 Specifies a filter pattern for tables to search for.
 When no table_name_filter_pattern is provided, all tables matching other filters are searched.
 In the pattern string, two special characters can be used to denote matching rules:
 - "%" means to match any substring with 0 or more characters.
 - "_" means to match any one character.
      optional string table_name_filter_pattern = 3;
      Parameters:
      value - The tableNameFilterPattern to set.
      Returns:
      This builder for chaining.

    • clearTableNameFilterPattern

      public FlightSql.CommandGetTables.Builder clearTableNameFilterPattern()
      
 Specifies a filter pattern for tables to search for.
 When no table_name_filter_pattern is provided, all tables matching other filters are searched.
 In the pattern string, two special characters can be used to denote matching rules:
 - "%" means to match any substring with 0 or more characters.
 - "_" means to match any one character.
      optional string table_name_filter_pattern = 3;
      Returns:
      This builder for chaining.

    • setTableNameFilterPatternBytes

      public FlightSql.CommandGetTables.Builder setTableNameFilterPatternBytes(com.google.protobuf.ByteString value)
      
 Specifies a filter pattern for tables to search for.
 When no table_name_filter_pattern is provided, all tables matching other filters are searched.
 In the pattern string, two special characters can be used to denote matching rules:
 - "%" means to match any substring with 0 or more characters.
 - "_" means to match any one character.
      optional string table_name_filter_pattern = 3;
      Parameters:
      value - The bytes for tableNameFilterPattern to set.
      Returns:
      This builder for chaining.

    • getTableTypesList

      public com.google.protobuf.ProtocolStringList getTableTypesList()
      
 Specifies a filter of table types which must match.
 The table types depend on vendor/implementation. It is usually used to separate tables from views or system tables.
 TABLE, VIEW, and SYSTEM TABLE are commonly supported.
      repeated string table_types = 4;
      Specified by:
      getTableTypesList in interface FlightSql.CommandGetTablesOrBuilder
      Returns:
      A list containing the tableTypes.

    • getTableTypesCount

      public int getTableTypesCount()
      
 Specifies a filter of table types which must match.
 The table types depend on vendor/implementation. It is usually used to separate tables from views or system tables.
 TABLE, VIEW, and SYSTEM TABLE are commonly supported.
      repeated string table_types = 4;
      Specified by:
      getTableTypesCount in interface FlightSql.CommandGetTablesOrBuilder
      Returns:
      The count of tableTypes.

    • getTableTypes

      public String getTableTypes(int index)
      
 Specifies a filter of table types which must match.
 The table types depend on vendor/implementation. It is usually used to separate tables from views or system tables.
 TABLE, VIEW, and SYSTEM TABLE are commonly supported.
      repeated string table_types = 4;
      Specified by:
      getTableTypes in interface FlightSql.CommandGetTablesOrBuilder
      Parameters:
      index - The index of the element to return.
      Returns:
      The tableTypes at the given index.

    • getTableTypesBytes

      public com.google.protobuf.ByteString getTableTypesBytes(int index)
      
 Specifies a filter of table types which must match.
 The table types depend on vendor/implementation. It is usually used to separate tables from views or system tables.
 TABLE, VIEW, and SYSTEM TABLE are commonly supported.
      repeated string table_types = 4;
      Specified by:
      getTableTypesBytes in interface FlightSql.CommandGetTablesOrBuilder
      Parameters:
      index - The index of the value to return.
      Returns:
      The bytes of the tableTypes at the given index.

    • setTableTypes

      public FlightSql.CommandGetTables.Builder setTableTypes(int index, String value)
      
 Specifies a filter of table types which must match.
 The table types depend on vendor/implementation. It is usually used to separate tables from views or system tables.
 TABLE, VIEW, and SYSTEM TABLE are commonly supported.
      repeated string table_types = 4;
      Parameters:
      index - The index to set the value at.
      value - The tableTypes to set.
      Returns:
      This builder for chaining.

    • addTableTypes

      public FlightSql.CommandGetTables.Builder addTableTypes(String value)
      
 Specifies a filter of table types which must match.
 The table types depend on vendor/implementation. It is usually used to separate tables from views or system tables.
 TABLE, VIEW, and SYSTEM TABLE are commonly supported.
      repeated string table_types = 4;
      Parameters:
      value - The tableTypes to add.
      Returns:
      This builder for chaining.

    • addAllTableTypes

      public FlightSql.CommandGetTables.Builder addAllTableTypes(Iterable<String> values)
      
 Specifies a filter of table types which must match.
 The table types depend on vendor/implementation. It is usually used to separate tables from views or system tables.
 TABLE, VIEW, and SYSTEM TABLE are commonly supported.
      repeated string table_types = 4;
      Parameters:
      values - The tableTypes to add.
      Returns:
      This builder for chaining.

    • clearTableTypes

      public FlightSql.CommandGetTables.Builder clearTableTypes()
      
 Specifies a filter of table types which must match.
 The table types depend on vendor/implementation. It is usually used to separate tables from views or system tables.
 TABLE, VIEW, and SYSTEM TABLE are commonly supported.
      repeated string table_types = 4;
      Returns:
      This builder for chaining.

    • addTableTypesBytes

      public FlightSql.CommandGetTables.Builder addTableTypesBytes(com.google.protobuf.ByteString value)
      
 Specifies a filter of table types which must match.
 The table types depend on vendor/implementation. It is usually used to separate tables from views or system tables.
 TABLE, VIEW, and SYSTEM TABLE are commonly supported.
      repeated string table_types = 4;
      Parameters:
      value - The bytes of the tableTypes to add.
      Returns:
      This builder for chaining.

    • getIncludeSchema

      public boolean getIncludeSchema()
       Specifies if the Arrow schema should be returned for found tables.
      bool include_schema = 5;
      Specified by:
      getIncludeSchema in interface FlightSql.CommandGetTablesOrBuilder
      Returns:
      The includeSchema.

    • setIncludeSchema

      public FlightSql.CommandGetTables.Builder setIncludeSchema(boolean value)
       Specifies if the Arrow schema should be returned for found tables.
      bool include_schema = 5;
      Parameters:
      value - The includeSchema to set.
      Returns:
      This builder for chaining.

    • clearIncludeSchema

      public FlightSql.CommandGetTables.Builder clearIncludeSchema()
       Specifies if the Arrow schema should be returned for found tables.
      bool include_schema = 5;
      Returns:
      This builder for chaining.