Skip to content

/AWS1/IF_GLU=>GETPARTITIONS()

About GetPartitions

Retrieves information about the partitions in a table.

Method Signature

METHODS /AWS1/IF_GLU~GETPARTITIONS
  IMPORTING
    !IV_CATALOGID TYPE /AWS1/GLUCATALOGIDSTRING OPTIONAL
    !IV_DATABASENAME TYPE /AWS1/GLUNAMESTRING OPTIONAL
    !IV_TABLENAME TYPE /AWS1/GLUNAMESTRING OPTIONAL
    !IV_EXPRESSION TYPE /AWS1/GLUPREDICATESTRING OPTIONAL
    !IV_NEXTTOKEN TYPE /AWS1/GLUTOKEN OPTIONAL
    !IO_SEGMENT TYPE REF TO /AWS1/CL_GLUSEGMENT OPTIONAL
    !IV_MAXRESULTS TYPE /AWS1/GLUPAGESIZE OPTIONAL
    !IV_EXCLUDECOLUMNSCHEMA TYPE /AWS1/GLUBOOLEANNULLABLE OPTIONAL
    !IV_TRANSACTIONID TYPE /AWS1/GLUTRANSACTIONIDSTRING OPTIONAL
    !IV_QUERYASOFTIME TYPE /AWS1/GLUTIMESTAMP OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_glugetpartitionsrsp
  RAISING
    /AWS1/CX_GLUENTITYNOTFOUNDEX
    /AWS1/CX_GLUFEDR8NSOURCEEX
    /AWS1/CX_GLUFEDSRCRETRYABLEEX
    /AWS1/CX_GLUGLUEENCEXCEPTION
    /AWS1/CX_GLUINTERNALSERVICEEX
    /AWS1/CX_GLUINVALIDINPUTEX
    /AWS1/CX_GLUINVALIDSTATEEX
    /AWS1/CX_GLUOPERATIONTIMEOUTEX
    /AWS1/CX_GLURESOURCENOTREADYEX
    /AWS1/CX_GLUCLIENTEXC
    /AWS1/CX_GLUSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING

Required arguments:

iv_databasename TYPE /AWS1/GLUNAMESTRING /AWS1/GLUNAMESTRING

The name of the catalog database where the partitions reside.

iv_tablename TYPE /AWS1/GLUNAMESTRING /AWS1/GLUNAMESTRING

The name of the partitions' table.

Optional arguments:

iv_catalogid TYPE /AWS1/GLUCATALOGIDSTRING /AWS1/GLUCATALOGIDSTRING

The ID of the Data Catalog where the partitions in question reside. If none is provided, the Amazon Web Services account ID is used by default.

iv_expression TYPE /AWS1/GLUPREDICATESTRING /AWS1/GLUPREDICATESTRING

An expression that filters the partitions to be returned.

The expression uses SQL syntax similar to the SQL WHERE filter clause. The SQL statement parser JSQLParser parses the expression.

Operators: The following are the operators that you can use in the Expression API call:

=

Checks whether the values of the two operands are equal; if yes, then the condition becomes true.

Example: Assume 'variable a' holds 10 and 'variable b' holds 20.

(a = b) is not true.

< >

Checks whether the values of two operands are equal; if the values are not equal, then the condition becomes true.

Example: (a < > b) is true.

>

Checks whether the value of the left operand is greater than the value of the right operand; if yes, then the condition becomes true.

Example: (a > b) is not true.

<

Checks whether the value of the left operand is less than the value of the right operand; if yes, then the condition becomes true.

Example: (a < b) is true.

>=

Checks whether the value of the left operand is greater than or equal to the value of the right operand; if yes, then the condition becomes true.

Example: (a >= b) is not true.

<=

Checks whether the value of the left operand is less than or equal to the value of the right operand; if yes, then the condition becomes true.

Example: (a <= b) is true.

AND, OR, IN, BETWEEN, LIKE, NOT, IS NULL

Logical operators.

Supported Partition Key Types: The following are the supported partition keys.

  • string

  • date

  • timestamp

  • int

  • bigint

  • long

  • tinyint

  • smallint

  • decimal

If an type is encountered that is not valid, an exception is thrown.

The following list shows the valid operators on each type. When you define a crawler, the partitionKey type is created as a STRING, to be compatible with the catalog partitions.

Sample API Call:

iv_nexttoken TYPE /AWS1/GLUTOKEN /AWS1/GLUTOKEN

A continuation token, if this is not the first call to retrieve these partitions.

io_segment TYPE REF TO /AWS1/CL_GLUSEGMENT /AWS1/CL_GLUSEGMENT

The segment of the table's partitions to scan in this request.

iv_maxresults TYPE /AWS1/GLUPAGESIZE /AWS1/GLUPAGESIZE

The maximum number of partitions to return in a single response.

iv_excludecolumnschema TYPE /AWS1/GLUBOOLEANNULLABLE /AWS1/GLUBOOLEANNULLABLE

When true, specifies not returning the partition column schema. Useful when you are interested only in other partition attributes such as partition values or location. This approach avoids the problem of a large response by not returning duplicate data.

iv_transactionid TYPE /AWS1/GLUTRANSACTIONIDSTRING /AWS1/GLUTRANSACTIONIDSTRING

The transaction ID at which to read the partition contents.

iv_queryasoftime TYPE /AWS1/GLUTIMESTAMP /AWS1/GLUTIMESTAMP

The time as of when to read the partition contents. If not set, the most recent transaction commit time will be used. Cannot be specified along with TransactionId.

RETURNING

oo_output TYPE REF TO /aws1/cl_glugetpartitionsrsp /AWS1/CL_GLUGETPARTITIONSRSP

Domain /AWS1/RT_ACCOUNT_ID
Primitive Type NUMC

Examples

Syntax Example

This is an example of the syntax for calling the method. It includes every possible argument and initializes every possible value. The data provided is not necessarily semantically accurate (for example the value "string" may be provided for something that is intended to be an instance ID, or in some cases two arguments may be mutually exclusive). The syntax shows the ABAP syntax for creating the various data structures.

DATA(lo_result) = lo_client->getpartitions(
  io_segment = new /aws1/cl_glusegment(
    iv_segmentnumber = 123
    iv_totalsegments = 123
  )
  iv_catalogid = |string|
  iv_databasename = |string|
  iv_excludecolumnschema = ABAP_TRUE
  iv_expression = |string|
  iv_maxresults = 123
  iv_nexttoken = |string|
  iv_queryasoftime = '20150101000000.0000000'
  iv_tablename = |string|
  iv_transactionid = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  LOOP AT lo_result->get_partitions( ) into lo_row.
    lo_row_1 = lo_row.
    IF lo_row_1 IS NOT INITIAL.
      LOOP AT lo_row_1->get_values( ) into lo_row_2.
        lo_row_3 = lo_row_2.
        IF lo_row_3 IS NOT INITIAL.
          lv_valuestring = lo_row_3->get_value( ).
        ENDIF.
      ENDLOOP.
      lv_namestring = lo_row_1->get_databasename( ).
      lv_namestring = lo_row_1->get_tablename( ).
      lv_timestamp = lo_row_1->get_creationtime( ).
      lv_timestamp = lo_row_1->get_lastaccesstime( ).
      lo_storagedescriptor = lo_row_1->get_storagedescriptor( ).
      IF lo_storagedescriptor IS NOT INITIAL.
        LOOP AT lo_storagedescriptor->get_columns( ) into lo_row_4.
          lo_row_5 = lo_row_4.
          IF lo_row_5 IS NOT INITIAL.
            lv_namestring = lo_row_5->get_name( ).
            lv_columntypestring = lo_row_5->get_type( ).
            lv_commentstring = lo_row_5->get_comment( ).
            LOOP AT lo_row_5->get_parameters( ) into ls_row_6.
              lv_key = ls_row_6-key.
              lo_value = ls_row_6-value.
              IF lo_value IS NOT INITIAL.
                lv_parametersmapvalue = lo_value->get_value( ).
              ENDIF.
            ENDLOOP.
          ENDIF.
        ENDLOOP.
        lv_locationstring = lo_storagedescriptor->get_location( ).
        LOOP AT lo_storagedescriptor->get_additionallocations( ) into lo_row_7.
          lo_row_8 = lo_row_7.
          IF lo_row_8 IS NOT INITIAL.
            lv_locationstring = lo_row_8->get_value( ).
          ENDIF.
        ENDLOOP.
        lv_formatstring = lo_storagedescriptor->get_inputformat( ).
        lv_formatstring = lo_storagedescriptor->get_outputformat( ).
        lv_boolean = lo_storagedescriptor->get_compressed( ).
        lv_integer = lo_storagedescriptor->get_numberofbuckets( ).
        lo_serdeinfo = lo_storagedescriptor->get_serdeinfo( ).
        IF lo_serdeinfo IS NOT INITIAL.
          lv_namestring = lo_serdeinfo->get_name( ).
          lv_namestring = lo_serdeinfo->get_serializationlibrary( ).
          LOOP AT lo_serdeinfo->get_parameters( ) into ls_row_6.
            lv_key = ls_row_6-key.
            lo_value = ls_row_6-value.
            IF lo_value IS NOT INITIAL.
              lv_parametersmapvalue = lo_value->get_value( ).
            ENDIF.
          ENDLOOP.
        ENDIF.
        LOOP AT lo_storagedescriptor->get_bucketcolumns( ) into lo_row_9.
          lo_row_10 = lo_row_9.
          IF lo_row_10 IS NOT INITIAL.
            lv_namestring = lo_row_10->get_value( ).
          ENDIF.
        ENDLOOP.
        LOOP AT lo_storagedescriptor->get_sortcolumns( ) into lo_row_11.
          lo_row_12 = lo_row_11.
          IF lo_row_12 IS NOT INITIAL.
            lv_namestring = lo_row_12->get_column( ).
            lv_integerflag = lo_row_12->get_sortorder( ).
          ENDIF.
        ENDLOOP.
        LOOP AT lo_storagedescriptor->get_parameters( ) into ls_row_6.
          lv_key = ls_row_6-key.
          lo_value = ls_row_6-value.
          IF lo_value IS NOT INITIAL.
            lv_parametersmapvalue = lo_value->get_value( ).
          ENDIF.
        ENDLOOP.
        lo_skewedinfo = lo_storagedescriptor->get_skewedinfo( ).
        IF lo_skewedinfo IS NOT INITIAL.
          LOOP AT lo_skewedinfo->get_skewedcolumnnames( ) into lo_row_9.
            lo_row_10 = lo_row_9.
            IF lo_row_10 IS NOT INITIAL.
              lv_namestring = lo_row_10->get_value( ).
            ENDIF.
          ENDLOOP.
          LOOP AT lo_skewedinfo->get_skewedcolumnvalues( ) into lo_row_13.
            lo_row_14 = lo_row_13.
            IF lo_row_14 IS NOT INITIAL.
              lv_columnvaluesstring = lo_row_14->get_value( ).
            ENDIF.
          ENDLOOP.
          LOOP AT lo_skewedinfo->get_skewedcolumnvaluelocmaps( ) into ls_row_15.
            lv_key_1 = ls_row_15-key.
            lo_value_1 = ls_row_15-value.
            IF lo_value_1 IS NOT INITIAL.
              lv_columnvaluesstring = lo_value_1->get_value( ).
            ENDIF.
          ENDLOOP.
        ENDIF.
        lv_boolean = lo_storagedescriptor->get_storedassubdirectories( ).
        lo_schemareference = lo_storagedescriptor->get_schemareference( ).
        IF lo_schemareference IS NOT INITIAL.
          lo_schemaid = lo_schemareference->get_schemaid( ).
          IF lo_schemaid IS NOT INITIAL.
            lv_glueresourcearn = lo_schemaid->get_schemaarn( ).
            lv_schemaregistrynamestrin = lo_schemaid->get_schemaname( ).
            lv_schemaregistrynamestrin = lo_schemaid->get_registryname( ).
          ENDIF.
          lv_schemaversionidstring = lo_schemareference->get_schemaversionid( ).
          lv_versionlongnumber = lo_schemareference->get_schemaversionnumber( ).
        ENDIF.
      ENDIF.
      LOOP AT lo_row_1->get_parameters( ) into ls_row_6.
        lv_key = ls_row_6-key.
        lo_value = ls_row_6-value.
        IF lo_value IS NOT INITIAL.
          lv_parametersmapvalue = lo_value->get_value( ).
        ENDIF.
      ENDLOOP.
      lv_timestamp = lo_row_1->get_lastanalyzedtime( ).
      lv_catalogidstring = lo_row_1->get_catalogid( ).
    ENDIF.
  ENDLOOP.
  lv_token = lo_result->get_nexttoken( ).
ENDIF.