SAP ABAP Class CL_SHDB_TAB_LOCATION (Provides a cache for table location on hosts)

Hierarchy

☛ SAP_BASIS (Software Component) SAP Basis Component
   ⤷ HAN-DB (Application Component) SAP HANA Database
     ⤷ SHDB (Package) Basis Package for HDB

Meta Relationship - Using

#	Relationship type	Using	Short Description	Created on
1	Inheritance (c INHERITING FROM c_ref)	CL_SHDB_BASE	base class for HANA DB objects	20121127
2	Interface implementation (CLASS c. INTERFACES i_ref)	IF_SERIALIZABLE_OBJECT	Serializable Object	20130312

Properties

Class	CL_SHDB_TAB_LOCATION
Short Description	Provides a cache for table location on hosts
Super Class	CL_SHDB_BASE	base class for HANA DB objects
Instantiability of a Class	0	Private
Final	☐

General Data

Message Class
Program status
Category	0
Package	SHDB	Basis Package for HDB
Created	20120509	SAP
Last change	20140121	SAP
Shared Memory-enabled	☐
Fixed point arithmetic	☑
Unicode checks active	☑

Forward declarations

#	Type group / Object type	Type	Type Description
1	ABAP	Type group use (TYPE-POOLS tp)	Type group use (TYPE-POOLS tp)

Interfaces

#	Interface	Abstract	Final	Description	Created on
1	IF_SERIALIZABLE_OBJECT	☐	☐	Serializable Object	20130312

Friends

Class CL_SHDB_TAB_LOCATION has no friend class.

Attributes

#	Attribute	Level	Visibility	Read only	Typing	Associated Type	Initial Value	Description	Created on
1	MC_DISTR_EQUAL_ROWS	Constant	Public	☐	Type reference (TYPE)	TV_DISTR_MODE	1		20120724
2	MC_DISTR_EQUAL_SIZE	Constant	Public	☐	Type reference (TYPE)	TV_DISTR_MODE	2		20120724
3	MC_DISTR_RANDOM	Constant	Public	☐	Type reference (TYPE)	TV_DISTR_MODE	3		20120724
4	MC_DISTR_ROUND_ROBIN	Constant	Public	☐	Type reference (TYPE)	TV_DISTR_MODE	0		20120724
5	_MR_CACHED_SH_ITER	Instance attribute	Private	☐	Object reference (TYPE REF TO)	IF_LIB_ITERABLE			20120724
6	_MR_CONN	Instance attribute	Private	☐	Object reference (TYPE REF TO)	CL_SQL_CONNECTION			20120724
7	_MR_INSTANCE	Static Attribute	Private	☐	Object reference (TYPE REF TO)	CL_SHDB_TAB_LOCATION			20120724
8	_MT_PARTLOC	Instance attribute	Private	☐	Type reference (TYPE)	TT_PARTLOC			20120724
9	_MV_CACHED_SH_TABLE	Instance attribute	Private	☐	Type reference (TYPE)	TABNAME			20120724

Methods

#	Method	Level	Visibility	Method type	Description	Created on
1	ACCUMULATE	Instance method	Public	Method	Accumulate all parts of table on one host	20120724
2	CONSTRUCTOR	Instance method	Private	Constructor	Private; use new() instead	20120724
3	DETERMINE	Instance method	Public	Method	Read the location of partitions of tables	20120724
4	DISTRIBUTE	Instance method	Public	Method	Distributes table parts across hosts - specifed by iterator	20120724
5	GET_LOC_ITER	Instance method	Public	Method	Provides an iterator on locations of a table	20120724
6	IS_CHANGED	Instance method	Public	Method	Specifies whether table is changed after last determine()	20120724
7	IS_DISTRIBUTED	Instance method	Public	Method	Specifies whether a table is distributed on different hosts	20120724
8	MARK_AS_CHANGED	Instance method	Public	Method	Mark table as changed; location information no longer valid	20120724
9	NEW	Static method	Public	Method	Creates Instance	20120724
10	RELEASE	Instance method	Public	Method	Removes cached location data of all or a single table	20130122
11	RELOCATE	Instance method	Public	Method	relocates a table partition on a certain host	20121127
12	SYNC_LOCATION	Static method	Public	Method	Relocates a table according to location of a pattern table	20130122
13	_GET_CACHED_SH_ITER	Instance method	Private	Method	Returns a sorted host iterator for a certain table	20120724
14	_GET_MOST_POPULATED_SERVER	Instance method	Private	Method	Provides the server mostly populated by a certain table	20120724

Events

Class CL_SHDB_TAB_LOCATION has no event.

Types

#	Type	Visibility	Typing	Associated Type	Description	Created on	Type Source
1	TS_PARTLOC	Public	See coding			20120724	begin of ts_partloc, table type tabname, partition TYPE i, host(64) type c, port type i, crit type i, changed type abap_bool, end of ts_partloc
2	TS_POP	Protected	See coding			20120724	BEGIN OF ts_pop, host(64) TYPE c, num TYPE i, END OF ts_pop
3	TT_PARTLOC	Public	See coding			20120724	tt_partloc TYPE STANDARD TABLE OF ts_partloc WITH KEY table
4	TT_POP	Protected	See coding			20120724	tt_pop TYPE STANDARD TABLE OF ts_pop
5	TV_DISTR_MODE	Public	Type reference (TYPE)	I		20120724

Method Signatures

Method ACCUMULATE Signature

#	Type	Parameter	Pass Value	Optional	Typing Method	Associated Type	Default value	Description	Created on
1	Importing	IV_DEST	Call by reference	☑	Type reference (TYPE)	CHAR64			20120724
2	Importing	IV_TABNAME	Call by reference	☐	Type reference (TYPE)	TABNAME			20120724

#	Exception	Resumable	Description	Created on
1	CX_SHDB_EXCEPTION	☐		20120724

Method CONSTRUCTOR Signature

#	Type	Parameter	Pass Value	Optional	Typing Method	Associated Type	Default value	Description	Created on
1	Importing	IR_CONN	Call by reference	☑	Object reference (TYPE REF TO)	CL_SQL_CONNECTION			20120724
2	Importing	IV_TABLE	Call by reference	☑	Type reference (TYPE)	TABNAME		create instance optimized for usage with one table only	20120724

#	Exception	Resumable	Description	Created on
1	CX_SHDB_EXCEPTION	☐		20120724

Method DETERMINE Signature

#	Type	Parameter	Pass Value	Optional	Typing Method	Associated Type	Default value	Description	Created on
1	Importing	IV_TABLE	Call by reference	☑	Type reference (TYPE)	TABNAME			20120724

#	Exception	Resumable	Description	Created on
1	CX_SHDB_EXCEPTION	☐		20120724

Method DISTRIBUTE Signature

#	Type	Parameter	Pass Value	Optional	Typing Method	Associated Type	Default value	Description	Created on
1	Importing	IR_HOST_ITER	Call by reference	☑	Object reference (TYPE REF TO)	IF_LIB_ITERABLE		basic iterator interface	20120724
2	Importing	IV_TABLE	Call by reference	☐	Type reference (TYPE)	TABNAME		Tabellenname	20120724

#	Exception	Resumable	Description	Created on
1	CX_SHDB_EXCEPTION	☐	exceptions of HANA DB objects	20120724

Method GET_LOC_ITER Signature

#	Type	Parameter	Pass Value	Optional	Typing Method	Associated Type	Default value	Description	Created on
1	Importing	IV_TABNAME	Call by reference	☐	Type reference (TYPE)	TABNAME			20120724
2	Returning	RR_LOC_ITER	Value transfer	☐	Object reference (TYPE REF TO)	IF_LIB_ITERABLE			20120724

Method GET_LOC_ITER on class CL_SHDB_TAB_LOCATION has no exception.

Method IS_CHANGED Signature

#	Type	Parameter	Pass Value	Optional	Typing Method	Associated Type	Default value	Description	Created on
1	Importing	IV_TABLE	Call by reference	☐	Type reference (TYPE)	TABNAME			20120724
2	Returning	RV_CHANGED	Value transfer	☐	Type reference (TYPE)	ABAP_BOOL			20120724

Method IS_CHANGED on class CL_SHDB_TAB_LOCATION has no exception.

Method IS_DISTRIBUTED Signature

#	Type	Parameter	Pass Value	Optional	Typing Method	Associated Type	Default value	Description	Created on
1	Importing	IV_TABLE	Call by reference	☐	Type reference (TYPE)	TABNAME			20120724
2	Returning	RV_DISTR	Value transfer	☐	Type reference (TYPE)	ABAP_BOOL			20120724

#	Exception	Resumable	Description	Created on
1	CX_SHDB_EXCEPTION	☐	exceptions of HANA DB objects	20120724

Method MARK_AS_CHANGED Signature

#	Type	Parameter	Pass Value	Optional	Typing Method	Associated Type	Default value	Description	Created on
1	Importing	IV_TABLE	Call by reference	☐	Type reference (TYPE)	TABNAME			20120724

Method MARK_AS_CHANGED on class CL_SHDB_TAB_LOCATION has no exception.

Method NEW Signature

#	Type	Parameter	Pass Value	Optional	Typing Method	Associated Type	Default value	Description	Created on
1	Importing	IR_CONN	Call by reference	☑	Object reference (TYPE REF TO)	CL_SQL_CONNECTION			20120724
2	Importing	IV_TABLE	Call by reference	☑	Type reference (TYPE)	TABNAME		create instance optimized for use with only one table	20120724
3	Returning	RR_REF	Value transfer	☐	Object reference (TYPE REF TO)	CL_SHDB_TAB_LOCATION			20120724

Method NEW on class CL_SHDB_TAB_LOCATION has no exception.

Method RELEASE Signature

#	Type	Parameter	Pass Value	Optional	Typing Method	Associated Type	Default value	Description	Created on
1	Importing	IV_TABLE	Call by reference	☑	Type reference (TYPE)	TABNAME		Tabellenname	20130122

Method RELEASE on class CL_SHDB_TAB_LOCATION has no exception.

Method RELOCATE Signature

#	Type	Parameter	Pass Value	Optional	Typing Method	Associated Type	Default value	Description	Created on
1	Importing	IV_HOST	Call by reference	☐	Type reference (TYPE)	TS_PARTLOC-HOST			20121127
2	Importing	IV_PARTITION	Call by reference	☐	Type reference (TYPE)	I			20121127
3	Importing	IV_PORT	Call by reference	☐	Type reference (TYPE)	TS_PARTLOC-PORT			20121127
4	Importing	IV_TABLE	Call by reference	☐	Type reference (TYPE)	TABNAME			20121127

#	Exception	Resumable	Description	Created on
1	CX_SHDB_EXCEPTION	☐		20121127

Method SYNC_LOCATION Signature

#	Type	Parameter	Pass Value	Optional	Typing Method	Associated Type	Default value	Description	Created on
1	Importing	IV_PATTERN	Call by reference	☐	Type reference (TYPE)	TABNAME		table used as pattern	20130122
2	Importing	IV_TABLE	Call by reference	☐	Type reference (TYPE)	TABNAME		table needs to be relocated	20130122

#	Exception	Resumable	Description	Created on
1	CX_SHDB_EXCEPTION	☐		20130122

Method _GET_CACHED_SH_ITER Signature

#	Type	Parameter	Pass Value	Optional	Typing Method	Associated Type	Default value	Description	Created on
1	Importing	IV_TABLE	Call by reference	☐	Type reference (TYPE)	TABNAME			20120724
2	Returning	RR_ITER	Value transfer	☐	Object reference (TYPE REF TO)	IF_LIB_ITERABLE			20120724

Method _GET_CACHED_SH_ITER on class CL_SHDB_TAB_LOCATION has no exception.

Method _GET_MOST_POPULATED_SERVER Signature

#	Type	Parameter	Pass Value	Optional	Typing Method	Associated Type	Default value	Description	Created on
1	Importing	IV_TABNAME	Call by reference	☐	Type reference (TYPE)	TABNAME			20120724
2	Returning	RV_HOST	Value transfer	☐	Type reference (TYPE)	CHAR64			20120724

Method _GET_MOST_POPULATED_SERVER on class CL_SHDB_TAB_LOCATION has no exception.

History

Last changed by/on	SAP	20140121
SAP Release Created in	740