From c2187086bca510974f2de1a56a7ea7ce36de7077 Mon Sep 17 00:00:00 2001 From: Soyoon-Choi Date: Mon, 15 Jan 2024 14:22:38 +0900 Subject: [PATCH 01/25] Spatial Data Type related Manuals Update MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit -Spatial SQL Reference : 개요와 각 함수의 세부 변경사항 수정 - iLoader User's Manual: -geom WKB 옵션 관련 내용과 예제 수정. 이 과정에서(공간 함수와는 관련 없지만) 누락된 옵션인 -extra_col_delimiter도 같이 수정했고, 일부 수정 사항은 -lightmode 수정 사항인 BUG-50747과 범위가 겹침.(50747 작업 시 크게 충돌 날 것은 아닙니다만 혹시 몰라서 알립니다) Utilities Manual - ILOADER_GEOM property 내용 추가 --- .../Altibase_7.3/eng/Spatial SQL Reference.md | 101 ++++++++++++++---- Manuals/Altibase_7.3/eng/Utilities Manual.md | 31 ++++++ .../Altibase_7.3/eng/iLoader User's Manual.md | 14 ++- 3 files changed, 126 insertions(+), 20 deletions(-) diff --git a/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md b/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md index e559fb520..f0879affd 100644 --- a/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md +++ b/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md @@ -867,7 +867,7 @@ INSERT INTO test1 VALUES (6, GEOMCOLLFROMTEXT('GEOMETRYCOLLECTION EMPTY')); In Altibase, the GEOMETRY data type can be represented using any of the three ways described below: -- WKT (Well-Known Text): A text format in which a spatial object is represented using letters and numbers. This allows it to be processed directly within SQL applications or other similar applications. The WKT format was designed using simple gramar for easy readability. +- WKT (Well-Known Text): A text format in which a spatial object is represented using letters and numbers. This allows it to be processed directly within SQL applications or other similar applications. The WKT format was designed using simple grammar for easy readability. - WKB (Well-Known Binary): A format in which a spatial object is represented in binary form. It was designed for the purpose of efficiently transferring and performing operations on GEOMETRY type data. - EWKT(Extended Well-Known Text) format: A text format in which Spatial Reference Identifier (SRID) information representing spatial objects has been added to the WKT format. - EWKB(Extended Well-Known Binary) format: A text format in which Spatial Reference Identifier (SRID) information representing spatial objects is added to the WKB format @@ -1192,9 +1192,8 @@ AThe spatial functions that are available in Altibase can be broadly classified - Spatial Analysis Functions These functions are used to perform various analytical tasks on GEOMETRY type data. - Spatial Object Creationg Functions - These functions are used to create spatial objects in WKT or WKB format, rather than in the internal storage format of Altibase. - +- Spatial Object Creation Functions + These functions are used to create spatial objects in WKT, WKB, EWKT, or EWKB format, rather than in the internal storage format of Altibase. ### Basic Spatial Functions @@ -3012,7 +3011,7 @@ F1 SRID(F2) ##### Syntax ``` -GEOMFROMTEXT( WKT) +GEOMFROMTEXT( WKT[, srid]) ``` ##### Description @@ -3023,7 +3022,7 @@ This function accepts a description of a spatial object in WKT (Well-known Text) The input can be any type of spatial object that can be described using WKT. If the syntax of the input WKT is not valid, this function outputs an error. -The SIRD of the created object is 0. +Users can set SRID during the creation of this object. Without any specific setting, the SRID of the created object is 0. ##### Return Value @@ -3048,6 +3047,12 @@ GEOMETRYCOLLECTION( POINT(10 10) , POINT(30 30) , LINESTRING(15 15, 20 20) ) iSQL> INSERT INTO TB3 VALUES (102, GEOMFROMTEXT('POLYGON((10 10, 10 20, 20 20, 20 15, 10))')); [ERR-A101A : Parsing error of well-known-text] + +iSQL> SELECT ASEWKT(GEOMFROMTEXT('POINT(1 1)', 100)) AS OBJ FROM DUAL; +OBJ +------------------------------------- +SRID=100;POINT(1 1) +1 row selected. ``` #### POINTFROMTEXT @@ -3055,7 +3060,7 @@ iSQL> INSERT INTO TB3 VALUES (102, GEOMFROMTEXT('POLYGON((10 10, 10 20, 20 20, 2 ##### Syntax ``` -POINTFROMTEXT( WKT) +POINTFROMTEXT( WKT[, srid] ) ``` ##### Description @@ -3066,7 +3071,7 @@ If the syntax of the input WKT is not valid, or if the WKT describes a GEOMETRY This function returns NULL if the value of the WKT argument is NULL. -The SIRD of the created object is 0. +Users can set SRID during the creation of this object. Without any specific setting, the SRID of the created object is 0. ##### Return Type @@ -3090,6 +3095,12 @@ POINT(10 10) iSQL> INSERT INTO TB3 VALUES (103, POINTFROMTEXT('GEOMETRYCOLLECTION( POINT(10 10), POINT(30 30), LINESTRING(15 15, 20 20))')); [ERR-A1019 : Not applicable object type] + +iSQL> SELECT ASEWKT(POINTFROMTEXT('POINT(1 1)', 100)) AS OBJ FROM DUAL; +OBJ +------------------------------------- +SRID=100;POINT(1 1) +1 row selected. ``` #### LINEFROMTEXT @@ -3097,7 +3108,7 @@ iSQL> INSERT INTO TB3 VALUES (103, POINTFROMTEXT('GEOMETRYCOLLECTION( POINT(10 1 ##### Syntax ``` -LINEFROMTEXT( WKT ) +LINEFROMTEXT( WKT[, srid] ) ``` ##### Description @@ -3108,7 +3119,7 @@ If the syntax of the input WKT is not valid, or if the WKT describes a GEOMETRY This function returns NULL if the value of the WKT argument is NULL. -The SIRD of the created object is 0. +Users can set SRID during the creation of this object. Without any specific setting, the SRID of the created object is 0. ##### Return Type @@ -3132,6 +3143,12 @@ LINESTRING(10 10, 20 20, 30 40) iSQL> INSERT INTO TB3 VALUES (104, LINEFROMTEXT('MULTIPOLYGON(((10 10, 10 20, 20 20, 20 15, 10 10)), ((60 60, 70 70, 80 60, 60 60)))')); [ERR-A1019 : Not applicable object type] + +iSQL> SELECT ASEWKT(LINEFROMTEXT('LINESTRING(10 10, 20 20, 30 40)', 100) ) FROM DUAL; +OBJ +------------------------------------- +SRID=100;LINESTRING(10 10, 20 20, 30 40) +1 row selected. ``` #### POLYFROMTEXT @@ -3150,7 +3167,7 @@ If the syntax of the input WKT is not valid, or if the WKT describes a GEOMETRY This function returns NULL if the value of the WKT argument is NULL. -The SRID of a created object is 0. +Users can set SRID during the creation of this object. Without any specific setting, the SRID of the created object is 0. ##### Return Type @@ -3185,6 +3202,11 @@ ID ASEWKT(OBJ) 120 SRID=100;POLYGON((10 10, 10 20, 20 20, 20 15, 10 10)) 2 rows selected. +iSQL> SELECT ASEWKT(POLYFROMTEXT('POLYGON((10 10, 10 20, 20 20, 20 15, 10 10))', 100)) AS OBJ FROM DUAL; +OBJ +------------------------------------- +SRID=100;POLYGON((10 10, 10 20, 20 20, 20 15, 10 10)) +1 row selected. ``` #### ST_POLYGONFROMTEXT @@ -3240,7 +3262,7 @@ ID ASEWKT(OBJ) ##### Syntax ``` -MPOINTFROMTEXT( WKT ) +MPOINTFROMTEXT( WKT[, srid] ) ``` ##### Description @@ -3251,7 +3273,7 @@ If the syntax of the input WKT is not valid, or if the WKT describes a GEOMETRY This function returns NULL if the value of the WKT argument is NULL. -The SRID of a created object is 0. +Users can set SRID during the creation of this object. Without any specific setting, the SRID of the created object is 0. ##### Return Type @@ -3275,6 +3297,13 @@ MULTIPOINT(10 10, 20 20) iSQL> INSERT INTO TB3 VALUES (106, MPOINTFROMTEXT('LINESTRING(10 10, 20 20, 30 40)')); [ERR-A1019 : Not applicable object type] + + +iSQL> SELECT ASEWKT( MPOINTFROMTEXT('MULTIPOINT(10 10, 20 20)', 100) ) AS OBJ FROM DUAL; +OBJ +------------------------------------- +SRID=100;MULTIPOINT(10 10, 20 20) +1 row selected. ``` #### MLINEFROMTEXT @@ -3282,7 +3311,7 @@ iSQL> INSERT INTO TB3 VALUES (106, MPOINTFROMTEXT('LINESTRING(10 10, 20 20, 30 4 ##### Syntax ``` -MLINEFROMTEXT( WKT ) +MLINEFROMTEXT( WKT[, srid] ) ``` ##### Description @@ -3293,7 +3322,7 @@ This function accepts a spatial object in WKT (Well-known Text) format as input This function returns NULL if the value of the WKT argument is NULL. -The SRID of a created object is 0. +Users can set SRID during the creation of this object. Without any specific setting, the SRID of the created object is 0. ##### Return Type @@ -3316,6 +3345,13 @@ MULTILINESTRING((10 10, 20 20), (15 15, 30 15)) 1 row selected. iSQL> INSERT INTO TB3 VALUES (107, MLINEFROMTEXT('POINT(10 10)')); [ERR-A1019 : Not applicable object type] + + +iSQL> SELECT ASEWKT(MLINEFROMTEXT('MULTILINESTRING((10 10, 20 20), (15 15, 30 15))', 100))AS OBJ FROM DUAL; +OBJ +------------------------------------- +SRID=100;MULTILINESTRING((10 10, 20 20), (15 15, 30 15)) +1 row selected. ``` #### MPOLYFROMTEXT @@ -3323,7 +3359,7 @@ iSQL> INSERT INTO TB3 VALUES (107, MLINEFROMTEXT('POINT(10 10)')); ##### Syntax ``` -MPOLYFROMTEXT( WKT ) +MPOLYFROMTEXT( WKT[, srid] ) ``` ##### Description @@ -3334,6 +3370,8 @@ If the syntax of the input WKT is not valid, or if the WKT describes a GEOMETRY This function returns NULL if the value of the WKT argument is NULL. +Users can set SRID during the creation of this object. Without any specific setting, the SRID of the created object is 0. + ##### Return Type ``` @@ -3356,6 +3394,13 @@ MULTIPOLYGON(((10 10, 10 20, 20 20, 20 15, 10 10)), ((60 60, 70 70, 80 60, 60 60 iSQL> INSERT INTO TB3 VALUES (108, MPOLYFROMTEXT('MULTIPOINT(10 10, 20 20)')); [ERR-A1019 : Not applicable object type] + + +iSQL> SELECT ASEWKT(MPOLYFROMTEXT('MULTIPOLYGON(((10 10, 10 20, 20 20, 20 15, 10 10)), ((60 60, 70 70, 80 60, 60 60)))',100)) AS OBJ FROM DUAL; +OBJ +------------------------------------- +SRID=100;MULTIPOLYGON(((10 10, 10 20, 20 20, 20 15, 10 10)), ((60 60, 70 70, 80 60, 60 60))) +1 row selected. ``` #### GEOMCOLLFROMTEXT @@ -3363,7 +3408,7 @@ iSQL> INSERT INTO TB3 VALUES (108, MPOLYFROMTEXT('MULTIPOINT(10 10, 20 20)')); ##### Syntax ``` -GEOMCOLLFROMTEXT( WKT ) +GEOMCOLLFROMTEXT( WKT[, srid] ) ``` ##### Description @@ -3374,6 +3419,8 @@ If the syntax of the input WKT is not valid, or if the WKT describes a GEOMETRY This function returns NULL if the value of the WKT argument is NULL. +Users can set SRID during the creation of this object. Without any specific setting, the SRID of the created object is 0. + ##### Return Type ``` @@ -3398,6 +3445,12 @@ GEOMETRYCOLLECTION( POINT(10 10) , POINT(30 30) , LINESTRING(15 15, 20 20) ) iSQL> INSERT INTO TB3 VALUES (109, GEOMCOLLFROMTEXT('POLYGON((10 10, 10 20, 20 20, 20 15, 10 10))')); [ERR-A1019 : Not applicable object type] + +iSQL> SELECT ASEWKT(GEOMCOLLFROMTEXT('GEOMETRYCOLLECTION(POINT(10 10), POINT(30 30), LINESTRING(15 15, 20 20))',100)) AS OBJ FROM DUAL; +OBJ +--------------------------------------------- +SRID=100;GEOMETRYCOLLECTION( POINT(10 10) , POINT(30 30) , LINESTRING(15 15, 20 20) ) +1 row selected. ``` #### ST_GEOMETRY @@ -6837,7 +6890,19 @@ else ``` -# Appendix A. Limitations on the Use of Spatial Data in Altiabase +# 4. Spatial Data Migration + +This section describes how to migrate spatial data between Atibase products or other vendor database products. + +### Spatial Data Migration Between Altibase Products + +For the migration of spatial data between Altibase products, iLoader and aexport can be utilized. Both utilities support spatial data types. + +One important consideration is the storage format for spatial data in Altibase. Based on the metadata version of the SYSTEM_.SYS_DATABASE_ table, versions below 8.8.1 support the WKB format, while versions 8.8.1 and above support the EWKB format. During migration, the extracted spatial data format follows the format of the Altibase where the spatial data is stored. Consequently, versions below 8.8.1 generate WKB format spatial data files, and versions 8.8.1 and above create EWKB format data files. + +Spatial data in WKB format is automatically recognized and converted by Altibase supporting EWKB. However, Altibase supporting WKB cannot recognize spatial data in EWKB format. Therefore, when transferring EWKB format data to an Altibase supporting WKB, the option to extract the original data in WKB format must be used. During migration tasks, use the 'ILOADER_GEOM = WKB' option in the aexport.properties file for aexport, and for a single table operation, use the '-geom WKB' option in iLoader. For detailed information, please refer to the iLoader and aexport manuals. + +# Appendix A. Limitations on the Use of Spatial Data in Altibase With the expansion of Altibase into the realm of spatial data, inevitably some of Altibase's extensive functionality lacks support for use with spatial data. The current limitations are explained in detail in this Appendix. diff --git a/Manuals/Altibase_7.3/eng/Utilities Manual.md b/Manuals/Altibase_7.3/eng/Utilities Manual.md index 933830180..2375ed6ea 100644 --- a/Manuals/Altibase_7.3/eng/Utilities Manual.md +++ b/Manuals/Altibase_7.3/eng/Utilities Manual.md @@ -693,102 +693,133 @@ When Altibase is installed, the \$ALTIBASE_HOME/conf directory does not actually OPERATION = IN/OUT If this property is set to OUT, scripts for exporting all schemas and data will be created. When the data export script, which consists of iLoader commands, is executed, form files (.fmt) and data files (.dat) will be created. If this property is set to IN, the schema creation script and the data loading script, which were created by previously executing aexport with this property set to OUT, will be executed, the schema will be created in the destination database, and the data will be loaded into the destination database. The schema creation script and the data loading script can be executed manually at a shell prompt without executing aexport. + - EXECUTE This property determines whether to automatically execute the scripts that were created. EXECUTE = ON/OFF If it is set to ON, the scripts that are appropriate for the current operation (set using the OPERATION property) will be executed automatically. The file names of these scripts are set using the ILOADER_OUT, ILOADER_IN, ISQL, ISQL_CON, ISQL_INDEX, ISQL_FOREIGN_KEY, ISQL_ALT_TBL, and ISQL_REPL properties. If it is set to OFF, the scripts will be created, but not executed. + - INVALID_SCRIPT This property determines whether to group all of the object creation scripts for invalid objects in a single script file. INVALID_SCRIPT = ON/OFF If this property is set to OFF, a SQL script file will be generated for each of the invalid objects in the database; that is, they will be treated just like the valid database objects. + - TWO_PHASE_SCRIPT This property determines whether to group all of the object creation scripts in two script files. TWO_PHASE_SCRIPT = ON/OFF If this property is set to ON, aexport will create only two SQL script files and two shell script files: ALL_OBJECT.sql, ALL_OBJECT_CONSTRAINS.sql, ALL_OBJECT.sql, run_is.sh, run_is_con.sh If this property is set to OFF, aexport will generate different SQL script files for each of the objects in a database. + - CRT_TBS_USER_MODE CRT_TBS_USER_MODE = ON/OFF (Default: OFF) This property determines whether or not to extract a statement for creating tablespace in user mode. If this property is set to ON, the SQL statement creating tablespace related to the user in the user mode is extracted. The user related tablespaces are default tablespace, default temporary tablespace, and the tablespace specified whether or not to available to be accessed. + - INDEX INDEX = ON/OFF This property determines whether or not to create the indexes when creating the rest of the schema in the destination database. If it is desired to create the indexes after the data have been located into the destination database, set this property to ON. It is used when the TWO_PHASE_SCRIPT property is set to OFF. + - USER_PASSWORD USER_PASSWORD = *password* This property is used to set the password when the users exported from the source database are created in the destination database. (Because aexport does not know the passwords of users exported from the source database, the passwords must be manually set.) If this property is not set, a prompt for setting each user's password will appear. + - VIEW_FORCE VIEW_FORCE = ON/OFF If this property is set to ON, views will be forcibly created, even if the underlying tables or other objects don't exist. + - DROP This property determines whether to include DROP statements in created scripts. DROP = ON/OFF If this property is set to ON, and if the destination database already contains objects corresponding to those that are to be created, the existing objects will be dropped. Because this option specifies that existing objects are to be dropped, it should be used with caution. Note) If aexport is executed in Object Mode, DROP statements are not generated, regardless of the setting of this property. + - ILOADER_OUT ILOADER_OUT = *run_il_out.sh* This property determines the name of the shell script file that is created to export (download) the data from the source database. It is used when the OPERATION property is set to OUT. + - ILOADER_IN ILOADER_IN = *run_il_in.sh* This property determines the name of the shell script file that will be used to import (upload) the data into the destination database. + - ISQL ISQL = *run_is.sh* This property determines the name of the script file that will be used to create the database schema in the destination database. + - ISQL_CON ISQL\_ CON = *run_is_con.sh* This property determines the name of the shell script file that is used to execute the SQL script files for creating indexes, foreign keys, triggers and replication objects. It is used when the TWO_PHASE_SCRIPT property is set to ON. + - ISQL_INDEX ISQL_INDEX = *run_is_index.sh* This property determines the name of the shell script that will be used to create indexes in the destination database. If no value is specified for this property in the aexport.properties file, this shell script file will not be generated. + - ISQL_FOREIGN_KEY ISQL\_ FOREIGN_KEY = *run_is_fk.sh* This property determines the name of the shell script file that is used to execute the SQL script files for creating foreign keys. If no value is specified for this property in the aexport.properties file, this shell script file will not be generated. + - ISQL_REPL ISQL_REPL = *run_is_repl.sh* This property determines the name of the shell script that will be used to create replication objects in the destination database. If no value is specified for this property in the aexport.properties file, this shell script file will not be generated. + - COLLECT_DBMS_STATS This property determines whether to display the statistics for tables, columns and indexes of specified user. COLLECT_DBMS_STATS = ON/OFF The default value is OFF and no statistical information is exported. When this property's value is ON, statistics information is exported. + - ISQL_REFERSH_MVIEW ISQL_REFERSH_MVIEW = *run_is_refresh_mview.sh* This property determines the name of the shell script that will be used to execute the SQL script files for refreshing the materialized view in the destination database. If no value is specified for this property in the aexport.properties file, this shell script file will not be generated. + - ISQL_ALT_TBL ISQL_ALT_TBL = *run_is_alt_tbl.sh* This property sets the name of the shell script file executing the SQL script which switches the data access mode for the tables and partitions of the target database. On omission, aexport does not generate this shell script file. + - ILOADER_FIELD_TERM ILOADER_FIELD_TERM = *field_term* This property is used to set the field delimiters that are used when the data in tables are saved as text. If this property is not set, the default delimiter between values is the comma (“,”), no block delimiters are used for numeric values, and double quotation marks (“ “ “) are used as block delimiters around strings. Note) The pound (i.e. hash or number sign) character “#” cannot be specified as a delimiter, because it is used to denote comments in the properties file (The remainder of the line after the “#” will be ignored). + - ILOADER_ROW_TERM ILOADER\_ ROW \_TERM = *row_term* This property sets the record delimiter to use wwhen texting table data. If not set, the default is . Note) The pound (i.e. hash or number sign) character “#” cannot be specified as the record delimiter, because it is used to denote comments in the properties file (The remainder of the line after the “#” will be ignored). + - ILOADER_PARTITION This property determines whether or not to create SQL scripts and shell scripts for creating partitions. ILOADER\_ PARTITION = ON/OFF If this property is set to ON, shell scripts for exporting data from partitions, for creating partitioned tables and all of their partitions, and for importing data into each partition are generated. In other words, enabling this property makes it possible to import data from table partitions in the source database into corresponding partitions in partitioned tables in the destination database. If this property is set to OFF, whether tables in the source database are partitioned is ignored, and the shell script that is generated creates non-partitioned tables in the destination database and imports data from all partitions of partitioned tables in the source database into corresponding non-partitioned tables in the destination database. For more detailed infomraiton, please refer to the *iLoader User's Manual.* + - ILOADER_ERRORS ILOADER_ERRORS = *count* (Default: 50) This property specifies the number of allowable maximum errors when uploading data with iLoader. The default value of this property is set to 50, and the upload is continuously executed regardless of the number of incurring errors if the default value is set to 0. + - ILOADER_ARRAY ILOADER_ARRAY = *count* (Default: 1) This property specifies the number of rows to be processed at once when downloading or uploading data with iLoader. + - ILOADER**\_**COMMIT ILOADER**\_**COMMIT = *count* (Default: 1000) This property specifies the unit(number) to commit when uploading the data with iLoader. The value of -commit option can be specified as well. + - ILOADER_PARALLEL ILOADER_PARALLEL = *count* (Default: 1) This property specifies the number of threads which will be executed with parallel processing when uploading or downloading with iLoader. + - ILOADER_ASYNC_PREFETCH ILOADER_ASYNC_PREFETCH = OFF\|ON\|AUTO (Default: OFF) This property sets asynchronous prefect behavior when downloading data to iLoader. For more information, please refer to the '-async_prefetch' option in the *iLoader User's Manual.* + - SSL_ENABLE This property specifies whether to connect to the target database using the SSL protocol. SSL_ENABLE = ON/OFF If this property is set to ON, SSL-related options are enabled for iSQL and iLoader commands in the shell scripts (run_is.sh and run_il_in.sh) to be executed on the target database. SSL-related options can be enabled with the SSL_CA, SSL_CAPATH, SSL_CERT, SSL_KEY, SSL_CIPHER, SSL_VERIFY properties. For further information about these properties, please refer to Parameters. + +- ILOADER_GEOM + + This property specifies the processing of spatial data in Well-Known Binary (WKB) format when downloading spatial data with WKB iLoader. The '-geom WKB' option is added to the run_il_out.sh file. diff --git a/Manuals/Altibase_7.3/eng/iLoader User's Manual.md b/Manuals/Altibase_7.3/eng/iLoader User's Manual.md index 1d0690751..a9e9611d8 100644 --- a/Manuals/Altibase_7.3/eng/iLoader User's Manual.md +++ b/Manuals/Altibase_7.3/eng/iLoader User's Manual.md @@ -408,7 +408,9 @@ iloader [-h] [-partition] [-dry-run] [-prefetch_rows] - [-async_prefetch off|on|auto]] + [-async_prefetch off|on|auto] + [-geom WKB]] + [-nologging] ``` @@ -459,6 +461,8 @@ iLoader is run with the following options. Where applicable, default values are | \-split *n* | Specifies the number of records to copy to each file (only meaningful when used with the -out option). After the command is executed, multiple backup files, each storing a number of records equal to n and having the names datefile.dat0, datafile.dat1, etc... will have been created. | | \-errors *count* | This specifies the maximum number of allowable errors when iLoader is executed with the -in option. If the number of errors exceeds the number specified here, execution terminates. If this option is omitted, the default is 50. If this value is set to 0, execution continues regardless of the number of errors. The number of errors occurring during the uploading operation may exceed the number specified here. When this option is used in conjunction with the -parallel option, if the number of errors exceeds the specified value for one of multiple threads executing in parallel, all threads are terminated. | | \-partition | If the table specified using the -T option is a partitioned table, a number of FORM files equal to the number of partitions in the table will be generated. The name of each FORM file will have this structure: [formfile_name.partition_name]. If the specified table is not a partitioned table, one FORM file, named formfile_name, will be generated. | +| -extra_col_delimiter | This is used to recognize the end of a record when column and record delimiters are consecutively positioned after the last column in a record.
For example, if a data file has a column delimiter '^' and a record delimiter '\n', and it has the following format, the -extra_col_delimiter option is required:
Kim^1077^RD^\n
Lee^1099^CS^\n
This can be used in conjunction with the -rule csv or -t option. | +| -geom [WKB] | During the execution of the out mode, this option is used to output spatial data in Well-Known Binary (WKB) format.
It is utilized to migrate spatial data in Altibase, which supports the Extended Well-Known Binary (EWKB) format, to a lower version that uses the WKB format. If this option is not used, it follows Altibase's spatial object support format. | - If the -S, -U and -P command-line options are omitted, the user will be prompted to enter the values of these options manually at the time of execution. @@ -1376,6 +1380,9 @@ Usage : { in | out | formout | structout | help } [-partition] [-dry-run] [-prefetch_rows] + [-async_prefetch off|on|auto] + [-geom WKB] + [-lightmode] iLoader> help help Ex) help [ in | out | formout | structout | exit | help ] @@ -1414,7 +1421,10 @@ $ iloader help [-rule csv] [-partition] [-dry-run] - [-prefetch_rows]] + [-prefetch_rows] + [-async_prefetch off|on|auto] + [-geom WKB] + [-lightmode]] -h : This screen -s : Specify server name to connect -u : Specify user name to connect From cb34b933c70d32cbae91712e5a2d1200999cc912 Mon Sep 17 00:00:00 2001 From: Soyoon-Choi Date: Mon, 15 Jan 2024 14:57:24 +0900 Subject: [PATCH 02/25] -lightmode update MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit iLoader User's Manual- -lightmode 관련 수정 사항을 업데이트 했습니다. BUG-50740과 수정 범위가 겹치는 곳이 있고 이 버그 자체의 수정 사항이 많지 않아 같은 브랜치에서 작업합니다. --- Manuals/Altibase_7.3/eng/iLoader User's Manual.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/Manuals/Altibase_7.3/eng/iLoader User's Manual.md b/Manuals/Altibase_7.3/eng/iLoader User's Manual.md index a9e9611d8..1379dc597 100644 --- a/Manuals/Altibase_7.3/eng/iLoader User's Manual.md +++ b/Manuals/Altibase_7.3/eng/iLoader User's Manual.md @@ -702,16 +702,17 @@ The following options can realize considerable performance gains when running iL | Factor | Description | | ------------------------------------------ | ------------------------------------------------------------ | -| \-array *array_size* | To increase the speed of a data uploading (“in”) operation, data read from a file are first organized into an array before being sent to the server.
Performance is increased because the number of times that communication with the server must be established is decreased. However, if this value is set excessively high, it can have the opposite effect. If a LOB column exists, -array is ignored. | +| \-array *array_size* | To increase the speed of a data uploading (“in”) operation, data read from a file are first organized into an array before being sent to the server.
Performance is increased because the number of times that communication with the server must be established is decreased. However, if this value is set excessively high, it can have the opposite effect. | | \-commit *commit_unit* | When uploading data, this option determines how many records are committed at one time after being inserted. By default, 1000 records are committed after being inserted.
If commit_unit is set to 0, the application runs in NONAUTOCOMMIT mode, in which the commit operation takes place only after all data have been inserted.
If commit_unit is set to 1, the application runs in AUTOCOMMIT mode, in which a commit operation takes place for every record at the time that it is inserted.
When this option is used together with the array option, the commit operation takes place after a number of records equal to array_size * commit_unit have been inserted. | -| \-atomic | This option is set to use the Atomic Array INSERT option. Atomic Array INSERT realizes better performance than Array Insert because Atomic Array INSERT handles a number of Insert statements (up to the size of the array) as a single transaction. This option must be used together with the -array option. Additionally, tables that contain LOB type columns cannot be handled using this option. Furthermore, this option is useful only when uploading data. | -| \-direct [log\|nolog] (Direct-Path INSERT) | This option is for use with the Direct-Path INSERT when uploading data to a disk table.
If neither log nor nolog is specified, log is the default. If using nolog mode, it is essential to back up the table in question. If execution fails in nolog mode, recovery to a normal state will be impossible.
If loading tables for which there are restrictions (Restrictions for Direct-Path INSERT), execution will automatically switch to the atomic option.
If the -array option has not been set, the size of the array will automatically be set to the maximum possible size (=USHRT_MAX-1, or 65535).
If the -commit option is omitted, its value will be set to 1. | +| \-atomic | This option is set to use the Atomic Array INSERT option. Atomic Array INSERT realizes better performance than Array Insert because Atomic Array INSERT handles a number of Insert statements (up to the size of the array) as a single transaction. This option must be used together with the -array option. Plus, this option is useful only when uploading data. | +| \-direct [log\|nolog] (Direct-Path INSERT) | This option is for use with the Direct-Path INSERT when uploading data to a disk table.
If neither log nor nolog is specified, log is the default. If using nolog mode, it is essential to back up the table in question. If execution fails in nolog mode, recovery to a normal state will be impossible.
If loading tables for which there are restrictions (Restrictions for Direct-Path INSERT), execution will automatically switch to the atomic option.
If the -array option has not been set, the size of the array will automatically be set to the maximum possible size (=USHRT_MAX-1, or 65535).
If the -commit option is omitted, its value will be set to 1.
This option cannot be used together with -lightmode option. | | \-parallel *count* | This specifies the number of threads that can operate at the same time. A number of threads can be created and executed in parallel up to the specified value, the maximum of which is 32. When downloading, a number of files equal to the specified value is created, and the data are saved therein.
When downloading with only the -parallel option set, the performance of repeated bind and fetch operations may be reduced. Therefore, when downloading data, the -parallel and -array options should be used together.
If a LOB column is present, this option is ignored. When uploading with the -parallel option, iloader creates *count + 1* connections, and when downloading with this option, iloader always creates two connections. Therefore, when uploading or downloading with this option via IPC, the value in the IPC_CHANNEL_COUNT property in altibase.properties must be equal to or greater than the number of these connections.
Default value: 1, Max value: 32 | -| \-readsize *n* | This is used as an option for the IN mode. This option specifies the amount of data that are read from a file at one time. The size must be greater than 0. The default is 1048576 bytes. | +| \-readsize *n* | This option specifies the amount of data that is read from a file at one time. The size must be greater than 0. The default is 1048576 bytes. | +| -lightmode | This option does not log the log files for faster data insertion when data loading. Since it does not record log files, it may be impossible to recover normally in case of a failure. In such cases, it is recommended to recreate the target table.
It can be used with the -parallel option, allowing multiple iLoader instances to insert data simultaneously. However, while iLoader is being executed with this option, other transactions cannot perform INSERT, UPDATE, or DELETE operations on the target table. Therefore, it cannot be used on tables targeted for replication, and users cannot create replication for tables on which data insertion is in progress with this option. This option does not support the direct-path insert method, so it cannot be used with the -direct option. | ##### LOB column constraints -If there is a LOB colum in the table to be uploaded, the value speicifed by the user is ignored for the following options and internally set as shown in the table below. +If there is a LOB column in the table to be uploaded, the value specified by the user is ignored for the following options and internally set as shown in the table below. | Option | Setting Value | | --------- | ------ | From a9950514aeca09fe56da1823c377465d66aa3208 Mon Sep 17 00:00:00 2001 From: Soyoon-Choi <151510931+Soyoon-Choi@users.noreply.github.com> Date: Mon, 15 Jan 2024 16:15:33 +0900 Subject: [PATCH 03/25] Update Manuals/Altibase_7.3/eng/Spatial SQL Reference.md --- Manuals/Altibase_7.3/eng/Spatial SQL Reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md b/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md index f0879affd..12f3a8aec 100644 --- a/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md +++ b/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md @@ -3022,7 +3022,7 @@ This function accepts a description of a spatial object in WKT (Well-known Text) The input can be any type of spatial object that can be described using WKT. If the syntax of the input WKT is not valid, this function outputs an error. -Users can set SRID during the creation of this object. Without any specific setting, the SRID of the created object is 0. +Users can specify SRID when using this function. If SRID is not specified, the SRID of the generated geometry object is 0. ##### Return Value From 874a748338191ed8111af6fa762eb358b28c751d Mon Sep 17 00:00:00 2001 From: Soyoon-Choi <151510931+Soyoon-Choi@users.noreply.github.com> Date: Mon, 15 Jan 2024 16:15:50 +0900 Subject: [PATCH 04/25] Update Manuals/Altibase_7.3/eng/Spatial SQL Reference.md --- Manuals/Altibase_7.3/eng/Spatial SQL Reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md b/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md index 12f3a8aec..214ff01ff 100644 --- a/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md +++ b/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md @@ -3071,7 +3071,7 @@ If the syntax of the input WKT is not valid, or if the WKT describes a GEOMETRY This function returns NULL if the value of the WKT argument is NULL. -Users can set SRID during the creation of this object. Without any specific setting, the SRID of the created object is 0. +Users can specify SRID when using this function. If SRID is not specified, the SRID of the generated geometry object is 0.``` ##### Return Type From d9d6a3aa8e96c86aea81a88ec06b2967e4971f3d Mon Sep 17 00:00:00 2001 From: Soyoon-Choi <151510931+Soyoon-Choi@users.noreply.github.com> Date: Mon, 15 Jan 2024 16:15:57 +0900 Subject: [PATCH 05/25] Update Manuals/Altibase_7.3/eng/Spatial SQL Reference.md --- Manuals/Altibase_7.3/eng/Spatial SQL Reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md b/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md index 214ff01ff..d05dec568 100644 --- a/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md +++ b/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md @@ -3119,7 +3119,7 @@ If the syntax of the input WKT is not valid, or if the WKT describes a GEOMETRY This function returns NULL if the value of the WKT argument is NULL. -Users can set SRID during the creation of this object. Without any specific setting, the SRID of the created object is 0. +Users can specify SRID when using this function. If SRID is not specified, the SRID of the generated geometry object is 0.``` ##### Return Type From 4278f6092afc62c79ed4de816555831d5508adc1 Mon Sep 17 00:00:00 2001 From: Soyoon-Choi <151510931+Soyoon-Choi@users.noreply.github.com> Date: Mon, 15 Jan 2024 16:16:03 +0900 Subject: [PATCH 06/25] Update Manuals/Altibase_7.3/eng/Spatial SQL Reference.md --- Manuals/Altibase_7.3/eng/Spatial SQL Reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md b/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md index d05dec568..e027b8415 100644 --- a/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md +++ b/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md @@ -3167,7 +3167,7 @@ If the syntax of the input WKT is not valid, or if the WKT describes a GEOMETRY This function returns NULL if the value of the WKT argument is NULL. -Users can set SRID during the creation of this object. Without any specific setting, the SRID of the created object is 0. +Users can specify SRID when using this function. If SRID is not specified, the SRID of the generated geometry object is 0.``` ##### Return Type From 13b9e3923748eb7185da737d282e744fdc4ea26d Mon Sep 17 00:00:00 2001 From: Soyoon-Choi <151510931+Soyoon-Choi@users.noreply.github.com> Date: Mon, 15 Jan 2024 16:16:09 +0900 Subject: [PATCH 07/25] Update Manuals/Altibase_7.3/eng/Spatial SQL Reference.md --- Manuals/Altibase_7.3/eng/Spatial SQL Reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md b/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md index e027b8415..d589dc34d 100644 --- a/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md +++ b/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md @@ -3273,7 +3273,7 @@ If the syntax of the input WKT is not valid, or if the WKT describes a GEOMETRY This function returns NULL if the value of the WKT argument is NULL. -Users can set SRID during the creation of this object. Without any specific setting, the SRID of the created object is 0. +Users can specify SRID when using this function. If SRID is not specified, the SRID of the generated geometry object is 0.``` ##### Return Type From d724e6e9bf359c9ffc09c120a2dcdb31dcfedee9 Mon Sep 17 00:00:00 2001 From: Soyoon-Choi <151510931+Soyoon-Choi@users.noreply.github.com> Date: Mon, 15 Jan 2024 16:16:15 +0900 Subject: [PATCH 08/25] Update Manuals/Altibase_7.3/eng/Spatial SQL Reference.md --- Manuals/Altibase_7.3/eng/Spatial SQL Reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md b/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md index d589dc34d..915f3f6c8 100644 --- a/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md +++ b/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md @@ -3322,7 +3322,7 @@ This function accepts a spatial object in WKT (Well-known Text) format as input This function returns NULL if the value of the WKT argument is NULL. -Users can set SRID during the creation of this object. Without any specific setting, the SRID of the created object is 0. +Users can specify SRID when using this function. If SRID is not specified, the SRID of the generated geometry object is 0.``` ##### Return Type From 98784b56cd52671e1d9c05000ac8cf6a2d32189d Mon Sep 17 00:00:00 2001 From: Soyoon-Choi <151510931+Soyoon-Choi@users.noreply.github.com> Date: Mon, 15 Jan 2024 16:17:18 +0900 Subject: [PATCH 09/25] Update Manuals/Altibase_7.3/eng/Spatial SQL Reference.md --- Manuals/Altibase_7.3/eng/Spatial SQL Reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md b/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md index 915f3f6c8..7d23e615c 100644 --- a/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md +++ b/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md @@ -3370,7 +3370,7 @@ If the syntax of the input WKT is not valid, or if the WKT describes a GEOMETRY This function returns NULL if the value of the WKT argument is NULL. -Users can set SRID during the creation of this object. Without any specific setting, the SRID of the created object is 0. +Users can specify SRID when using this function. If SRID is not specified, the SRID of the generated geometry object is 0. ##### Return Type From 09ca833355b8e4d95e493af65e97ad962b99ce27 Mon Sep 17 00:00:00 2001 From: Soyoon-Choi <151510931+Soyoon-Choi@users.noreply.github.com> Date: Mon, 15 Jan 2024 16:17:32 +0900 Subject: [PATCH 10/25] Update Manuals/Altibase_7.3/eng/Spatial SQL Reference.md --- Manuals/Altibase_7.3/eng/Spatial SQL Reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md b/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md index 7d23e615c..28240adda 100644 --- a/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md +++ b/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md @@ -3419,7 +3419,7 @@ If the syntax of the input WKT is not valid, or if the WKT describes a GEOMETRY This function returns NULL if the value of the WKT argument is NULL. -Users can set SRID during the creation of this object. Without any specific setting, the SRID of the created object is 0. +Users can specify SRID when using this function. If SRID is not specified, the SRID of the generated geometry object is 0.``` ##### Return Type From cc860a6a6f7dabc49a77955e3e7bae190deefd26 Mon Sep 17 00:00:00 2001 From: Soyoon-Choi <151510931+Soyoon-Choi@users.noreply.github.com> Date: Mon, 15 Jan 2024 16:19:28 +0900 Subject: [PATCH 11/25] Update Manuals/Altibase_7.3/eng/Spatial SQL Reference.md --- Manuals/Altibase_7.3/eng/Spatial SQL Reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md b/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md index 28240adda..162b936a5 100644 --- a/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md +++ b/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md @@ -3071,7 +3071,7 @@ If the syntax of the input WKT is not valid, or if the WKT describes a GEOMETRY This function returns NULL if the value of the WKT argument is NULL. -Users can specify SRID when using this function. If SRID is not specified, the SRID of the generated geometry object is 0.``` +Users can specify SRID when using this function. If SRID is not specified, the SRID of the generated geometry object is 0. ##### Return Type From 06ca37364a410c84ec667fbc5e2c7d3df62a5d4a Mon Sep 17 00:00:00 2001 From: Soyoon-Choi <151510931+Soyoon-Choi@users.noreply.github.com> Date: Mon, 15 Jan 2024 16:20:36 +0900 Subject: [PATCH 12/25] Update Manuals/Altibase_7.3/eng/Spatial SQL Reference.md --- Manuals/Altibase_7.3/eng/Spatial SQL Reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md b/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md index 162b936a5..05dbcb551 100644 --- a/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md +++ b/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md @@ -3419,7 +3419,7 @@ If the syntax of the input WKT is not valid, or if the WKT describes a GEOMETRY This function returns NULL if the value of the WKT argument is NULL. -Users can specify SRID when using this function. If SRID is not specified, the SRID of the generated geometry object is 0.``` +Users can specify SRID when using this function. If SRID is not specified, the SRID of the generated geometry object is 0. ##### Return Type From fd432929035cb11efa085e32b59ce50757811048 Mon Sep 17 00:00:00 2001 From: Soyoon-Choi <151510931+Soyoon-Choi@users.noreply.github.com> Date: Mon, 15 Jan 2024 16:20:44 +0900 Subject: [PATCH 13/25] Update Manuals/Altibase_7.3/eng/Spatial SQL Reference.md --- Manuals/Altibase_7.3/eng/Spatial SQL Reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md b/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md index 05dbcb551..c899b99d1 100644 --- a/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md +++ b/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md @@ -3322,7 +3322,7 @@ This function accepts a spatial object in WKT (Well-known Text) format as input This function returns NULL if the value of the WKT argument is NULL. -Users can specify SRID when using this function. If SRID is not specified, the SRID of the generated geometry object is 0.``` +Users can specify SRID when using this function. If SRID is not specified, the SRID of the generated geometry object is 0. ##### Return Type From 14819ac84f1d3cd09931f16497710b983875f5cd Mon Sep 17 00:00:00 2001 From: Soyoon-Choi <151510931+Soyoon-Choi@users.noreply.github.com> Date: Mon, 15 Jan 2024 16:20:52 +0900 Subject: [PATCH 14/25] Update Manuals/Altibase_7.3/eng/Spatial SQL Reference.md --- Manuals/Altibase_7.3/eng/Spatial SQL Reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md b/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md index c899b99d1..792b9133a 100644 --- a/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md +++ b/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md @@ -3119,7 +3119,7 @@ If the syntax of the input WKT is not valid, or if the WKT describes a GEOMETRY This function returns NULL if the value of the WKT argument is NULL. -Users can specify SRID when using this function. If SRID is not specified, the SRID of the generated geometry object is 0.``` +Users can specify SRID when using this function. If SRID is not specified, the SRID of the generated geometry object is 0. ##### Return Type From 15db989f79eeead721e5ae8e9ef4b8d821a1b44a Mon Sep 17 00:00:00 2001 From: Soyoon-Choi <151510931+Soyoon-Choi@users.noreply.github.com> Date: Mon, 15 Jan 2024 16:20:59 +0900 Subject: [PATCH 15/25] Update Manuals/Altibase_7.3/eng/Spatial SQL Reference.md --- Manuals/Altibase_7.3/eng/Spatial SQL Reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md b/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md index 792b9133a..220fa08a0 100644 --- a/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md +++ b/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md @@ -3167,7 +3167,7 @@ If the syntax of the input WKT is not valid, or if the WKT describes a GEOMETRY This function returns NULL if the value of the WKT argument is NULL. -Users can specify SRID when using this function. If SRID is not specified, the SRID of the generated geometry object is 0.``` +Users can specify SRID when using this function. If SRID is not specified, the SRID of the generated geometry object is 0. ##### Return Type From 5695540ef15586bee78cfee3cbf2316abd0fefce Mon Sep 17 00:00:00 2001 From: Soyoon-Choi <151510931+Soyoon-Choi@users.noreply.github.com> Date: Mon, 15 Jan 2024 16:21:07 +0900 Subject: [PATCH 16/25] Update Manuals/Altibase_7.3/eng/Spatial SQL Reference.md --- Manuals/Altibase_7.3/eng/Spatial SQL Reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md b/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md index 220fa08a0..54d0fc5c2 100644 --- a/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md +++ b/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md @@ -3273,7 +3273,7 @@ If the syntax of the input WKT is not valid, or if the WKT describes a GEOMETRY This function returns NULL if the value of the WKT argument is NULL. -Users can specify SRID when using this function. If SRID is not specified, the SRID of the generated geometry object is 0.``` +Users can specify SRID when using this function. If SRID is not specified, the SRID of the generated geometry object is 0. ##### Return Type From 1637005cc0146329f480dc6e74c5102fa16f4f04 Mon Sep 17 00:00:00 2001 From: Soyoon-Choi Date: Tue, 16 Jan 2024 14:10:22 +0900 Subject: [PATCH 17/25] =?UTF-8?q?=EA=B5=AD=EB=AC=B8=20=EA=B3=B5=EA=B0=84?= =?UTF-8?q?=20=EB=8D=B0=EC=9D=B4=ED=84=B0=20=EB=A7=88=EC=9D=B4=EA=B7=B8?= =?UTF-8?q?=EB=A0=88=EC=9D=B4=EC=85=98=20=EC=88=98=EC=A0=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../Altibase_7.3/kor/Spatial SQL Reference.md | 17 ++++++++++++----- 1 file changed, 12 insertions(+), 5 deletions(-) diff --git a/Manuals/Altibase_7.3/kor/Spatial SQL Reference.md b/Manuals/Altibase_7.3/kor/Spatial SQL Reference.md index df77ecd33..1728c8448 100644 --- a/Manuals/Altibase_7.3/kor/Spatial SQL Reference.md +++ b/Manuals/Altibase_7.3/kor/Spatial SQL Reference.md @@ -7374,15 +7374,22 @@ else ``` # 4. 공간 데이터 마이그레이션 -본 장에서는 Altibase 또는 타 벤더 데이터베이스 제품과 공간 데이터 마이그레이션 하는 방법을 설명한다. +본 장에서는 Altibase 또는 타 벤더 데이터베이스 제품과 공간 데이터 마이그레이션 하는 방법을 설명한다. -### Altibase 제품간 공간 데이터 마이그레이션 +### Altibase 제품 간 공간 데이터 마이그레이션 -Altibase 제품간 공간 데이터 마이그레이션을 위해 iLoader와 aexport를 사용가능하다. 데이터 이관을 위한 iLoader와 마이그레이션을 위한 aexport는 공간 데이터를 지원하기에 다른 데이터 타입과 동일한 방식으로 마이그레이션이 가능하다. +Altibase 메타 버전 8.8.1부터 지원하는 공간 데이터 저장 포맷이 WKB에서 EWKB로 변경되었다. 사용자는 데이터 마이그레이션 수행 시 각 Altibase 제품의 메타 버전과 어떤 공간 데이터 저장 포맷을 지원하는 지 확인해야 한다. 메타 버전은 SYSTEM\_.SYS\_DATABASE_ 테이블에서 확인할 수 있다. + +메타 버전에 따라 지원하는 공간 데이터 저장 포맷은 다음과 같다. + +- 메타 버전 8.8.1 미만: WKB 포맷 +- 메타 버전 8.8.1 이상: EWKB 포맷 + +Altibase 제품 간 공간 데이터 마이그레이션은 iLoader나 aexport를 사용한다. 이 유틸리티들은 공간 데이터 추출 시 각 메타 버전이 지원하는 포맷의 데이터 파일을 생성한다. 지원하는 공간 데이터 포맷이 같은 제품 간 데이터 마이그레이션 수행 방법은 기존과 같다. 또한, 메타 버전이 8.8.1 미만인 제품에서 8.8.1 이상인 제품으로 데이터를 이관하는 방법 또한 달라지지 않았다. 하지만, **메타 버전이 8.8.1 이상인 제품에서 8.8.1 미만인 제품으로 마이그레이션을 수행할 때에는 추가적인 작업이 필요하다**. + +WKB 포맷을 지원하는 Altibase는 EWKB 포맷 공간 데이터를 인식하지 못한다. 따라서 Altibase는 EWKB 포맷 공간 데이터를 WKB 포맷으로 추출하는 기능을 제공한다. 이 기능을 사용하기 위해서는 aexport.properties 파일에 'ILOADER_GEOM = WKB'를 추가해야 한다. 만약 특정 테이블만 마이그레이션 하려는 경우라면 iLoader에서 '-geom WKB' 옵션을 사용한다. 상세 내용은 iLoader와 aexport 매뉴얼을 참조한다. -한가지 주의할 점은 Altibase가 공간 데이터를 저장하는 포맷이다. SYSTEM\_.SYS\_DATABASE\_ 테이블 기준 메타 버젼 8.8.1 미만 버젼은 WKB 포맷을, 8.8.1이상 버젼은 EWKB 포맷을 지원한다. 마이그레이션 수행 시 추출되는 공간 데이터의 포맷은 공간 데이터가 저장된 Altibase가 지원하는 포맷에 따른다. 따라서, 8.8.1 미만 버젼은 WKB 포맷 공간 데이터 파일이 생성되고, 8.8.1이상 버젼은 EWKB 포맷 데이터 파일을 생성한다. -WKB 포맷의 공간 데이터는 EWKB 지원 Altibase가 읽고 자동으로 변환한다. 반면, EWKB 포맷 공간 데이터는 WKB 지원 Altibase가 인식하지 못한다. 따라서, EWKB 포맷 데이터를 WKB 지원 Altibase로 데이터 이관 할때 원본 데이터를 WKB 포맷으로 추출하는 옵션을 사용해야 한다. 마이그레이션 작업할 때는 aexport의 aexport.properties 파일에 'ILOADER_GEOM = WKB' 옵션을, 하나의 테이블만 작업할 때는 iLoader에서 '-geom WKB' 옵션을 사용한다. 상세 내용은 iLoader와 aexport 매뉴얼을 참조한다. # A.부록: Spatial 칼럼의 제약사항 From 804fb16bb98db58586f16c60fd2b87243aded673 Mon Sep 17 00:00:00 2001 From: Soyoon-Choi Date: Tue, 16 Jan 2024 14:15:27 +0900 Subject: [PATCH 18/25] Update Utilities Manual.md --- Manuals/Altibase_7.3/kor/Utilities Manual.md | 36 +++++++++++++++++--- 1 file changed, 32 insertions(+), 4 deletions(-) diff --git a/Manuals/Altibase_7.3/kor/Utilities Manual.md b/Manuals/Altibase_7.3/kor/Utilities Manual.md index 253f548b9..7b1e93166 100644 --- a/Manuals/Altibase_7.3/kor/Utilities Manual.md +++ b/Manuals/Altibase_7.3/kor/Utilities Manual.md @@ -915,6 +915,7 @@ Altibase를 설치할 때, aexport.properties 파일은 \$ALTIBASE_HOME/conf에 스크립트를 실행하여 대상 데이터베이스에 스키마를 만들고 데이터를 입력한다. 스키마 생성 스크립트와 데이터 입력 스크립트는 aexport를 실행하지 않고 쉘 프롬프트에서 수동으로 실행할 수도 있다. + - EXECUTE 생성한 스크립트를 자동으로 수행할 것인지 여부를 설정한다. EXECUTE = ON/OFF @@ -923,6 +924,7 @@ Altibase를 설치할 때, aexport.properties 파일은 \$ALTIBASE_HOME/conf에 ISQL_INDEX, ISQL_FOREIGN_KEY, ISQL_REPL, ISQL_REFRESH_MVIEW, 그리고 ISQL_ALT_TBL 프로퍼티로 설정된다. OFF일 경우 스크립트를 생성하기만 하고 실행하지는 않는다. + - INVALID_SCRIPT 이 프로퍼티는 유효하지 않은 객체들을 생성하는 SQL 스크립트를 하나의 스크립트 파일에 모을 것인지 여부를 결정한다. @@ -931,6 +933,7 @@ Altibase를 설치할 때, aexport.properties 파일은 \$ALTIBASE_HOME/conf에 프로시저를 생성하는 모든 SQL 스크립트를 포함한다. OFF이면, 유효하지 않은 각 객체를 생성하는 SQL 스크립트가 따로 생성된다. 즉, 유효한 객체와 같은 방식으로 다뤄진다. + - TWO_PHASE_SCRIPT 이 프로퍼티는 객체 생성 스크립트를 두 개의 스크립트 파일로 나눠서 생성할 것인지를 결정한다. @@ -939,6 +942,7 @@ Altibase를 설치할 때, aexport.properties 파일은 \$ALTIBASE_HOME/conf에 파일만이 생성된다: ALL_OBJECT.sql, ALL_OBJECT_CONSTRAINS.sql, ALL_OBJECT.sql, run_is.sh, run_is_con.sh OFF이면, 각 객체를 생성하는 SQL 스크립트 파일을 따로 생성한다. + - CRT_TBS_USER_MODE CRT_TBS_USER_MODE = ON/OFF (기본값: OFF) 사용자 모드에서 테이블스페이스 생성 구문을 추출할 것인지 여부를 결정한다. @@ -946,20 +950,24 @@ Altibase를 설치할 때, aexport.properties 파일은 \$ALTIBASE_HOME/conf에 테이블스페이스를 생성하는 SQL문을 추출한다. 사용자 관련 테이블스페이스는 기본 테이블스페이스, 기본 임시 테이블스페이스, 접근 가능 여부가 설정된 테이블스페이스이다. + - INDEX INDEX = ON/OFF 대상 데이터베이스에 스키마 구성 시 인덱스 포함여부를 결정한다. 데이터 로딩 후에 인덱스를 생성하고자 할 경우 이 프로퍼티를 ON으로 설정한다. TWO_PHASE_SCRIPT프로퍼티는 OFF일 때 제대로 동작한다. + - USER_PASSWORD USER_PASSWORD = *password* 원본 데이터베이스에서 추출된 사용자를 대상 데이터베이스에 생성할 때 사용할 암호를 지정한다. (aexport는 사용자 객체 추출 시 사용자의 암호를 알 수 없기 때문에 수동 설정이 필요하다.) 이 프로퍼티가 설정되어 있지 않을 경우 각 사용자의 암호를 묻는 프롬프트가 나타난다. + - VIEW_FORCE VIEW_FORCE = ON/OFF ON이면, 뷰의 기본 테이블 등이 존재하지 않아도 뷰를 강제로 생성한다. + - DROP 생성 스크립트 내부에 DROP 구문을 포함할 것인지 여부를 결정한다. DROP = ON/OFF @@ -968,53 +976,64 @@ Altibase를 설치할 때, aexport.properties 파일은 \$ALTIBASE_HOME/conf에 때문에 사용에 주의를 요한다. 주의) 객체 모드로 실행하면, 이 프로퍼티 값에 상관없이 DROP 구문이 생성되지 않는다. + - ILOADER_OUT ILOADER_OUT = *run_il_out.sh* 원 데이터베이스에서 데이터를 추출하기 위해 생성되는 쉘 스크립트 파일명을 설정한다. OPERATION 프로퍼티를 OUT으로 설정할 경우에 사용된다. + - ILOADER_IN ILOADER_IN = *run_il_in.sh* 대상 데이터베이스에 데이터 로딩을 위해 사용될 쉘 스크립트의 파일명을 설정한다. + - ISQL ISQL = *run_is.sh* 대상 데이터베이스에 데이터베이스 스키마를 구성하기 위한 SQL 스크립트를 실행하는 쉘 스크립트 파일의 이름을 설정한다. + - ISQL_CON ISQL\_ CON = *run_is_con.sh* 대상 데이터베이스에 인덱스, 외래키, 트리거와 이중화 객체를 생성하는 SQL 스크립트를 실행하는 쉘 스크립트 파일의 이름을 설정한다. TWO_PHASE_SCRIPT 프로퍼티가 ON일 때 사용된다. + - ISQL_INDEX ISQL_INDEX = *run_is_index.sh* 대상 데이터베이스에 인덱스를 생성하는 SQL 스크립트를 실행하는 쉘 스크립트 파일의 이름을 설정한다. 이 프로퍼티를 설정하지 않으면 쉘 스크립트 파일은 생성되지 않는다. + - ISQL_FOREIGN_KEY ISQL\_ FOREIGN_KEY = *run_is_fk.sh* 대상 데이터베이스에 외래키 생성하는 SQL 스크립트를 실행하는 쉘 스크립트 파일의 이름을 설정한다. 이 프로퍼티를 설정하지 않으면 쉘 스크립트 파일은 생성되지 않는다. + - ISQL_REPL ISQL_REPL = *run_is_repl.sh* 대상 데이터베이스에 이중화를 생성하기 위한 쉘 스크립트의 파일명을 설정한다. 이 프로퍼티를 설정하지 않으면 쉘 스크립트 파일은 생성되지 않는다. + - COLLECT_DBMS_STATS 이 프로퍼티는 사용자의 테이블, 칼럼, 인덱스의 통계 정보를 추출할지 여부를 결정한다. COLLECT_DBMS_STATS = ON/OFF 기본값은 OFF이며 통계 정보를 추출하지 않는다. 이 프로퍼티의 값을 ON으로 할 경우 통계 정보를 추출하도록 한다. + - ISQL_REFERSH_MVIEW ISQL_REFERSH_MVIEW = *run_is_refresh_mview.sh* 대상 데이터베이스의 Materialized View를 리프레쉬하는 SQL 스크립트를 실행하는 쉘 스크립트 파일의 이름을 설정한다. 이 프로퍼티를 설정하지 않으면, 쉘 스크립트 파일이 생성되지 않는다. + - ISQL_ALT_TBL ISQL_ALT_TBL = *run_is_alt_tbl.sh* 대상 데이터베이스의 테이블과 파티션에 대한 접근 모드를 변경하는 SQL 스크립트를 실행하는 쉘 스크립트 파일의 이름을 설정한다. 이 프로퍼티를 설정하지 않으면, 쉘 스크립트 파일이 생성되지 않는다. + - ILOADER_FIELD_TERM ILOADER_FIELD_TERM = *field_term* 테이블의 데이터를 텍스트로 다운로드 할 때 사용할 필드 구분자를 설정한다. @@ -1022,12 +1041,14 @@ Altibase를 설치할 때, aexport.properties 파일은 \$ALTIBASE_HOME/conf에 큰 따옴표(“”)로 에워싸여서 출력된다. 주의) 프로퍼티 파일 내에서 \# 문자를 구분자로 사용할 경우, \# 이하를 주석으로 처리하기 때문에, \#는 구분자로 사용할 수 없다. + - ILOADER_ROW_TERM ILOADER\_ ROW \_TERM = *row_term* 테이블 데이터를 텍스트로 내릴 때 사용할 레코드 구분자를 설정한다. 설정하지 않을 경우 기본값은 \이다. 주의) 프로퍼티 파일 내에서 \# 문자를 구분자로 사용할 경우, \# 이하를 주석으로 처리하기 때문에, \#는 구분자로 사용할 수 없다. + - ILOADER_PARTITION 이 프로퍼티는 파티션 생성을 위한 SQL 스크립트와 쉘 스크립트를 만들 것인지를 결정한다. @@ -1043,28 +1064,34 @@ Altibase를 설치할 때, aexport.properties 파일은 \$ALTIBASE_HOME/conf에 non-partitioned 테이블에 입력한다. ILOADER 관련 프로퍼티에 대한 더 자세한 설명은 *iLoader User’s Manual* 을 참고하기 바란다. + - ILOADER_ERRORS ILOADER_ERRORS = *count* (기본값: 50) iLoader로 데이터를 업로드할 때 허용 가능한 최대 에러 개수를 지정한다. 이 프로퍼티의 기본값은 50이며, 0으로 설정하면 발생하는 에러 개수와 무관하게 업로드가 계속 실행된다. + - ILOADER_ARRAY ILOADER_ARRAY = *count* (기본값: 1) iLoader로 데이터를 다운로드 또는 업로드 할 때 한 번에 처리할 row 개수를 지정한다. + - ILOADER_COMMIT ILOADER_COMMIT = *count* (기본값: 1000) iLoader로 데이터를 업로드할 때 커밋할 단위(개수)를 지정한다. 이 프로퍼티로 -commit옵션의 값을 지정할 수 있다. + - ILOADER_PARALLEL ILOADER_PARALLEL = *count* (기본값: 1) iLoader로 데이터를 다운로드 또는 업로드 할 때 병렬로 처리할 쓰레드 개수를 지정한다. + - ILOADER_ASYNC_PREFETCH ILOADER_ASYNC_PREFETCH = OFF\|ON\|AUTO (기본값 OFF) iLoader로 데이터를 다운로드할 때 비동기 prefetch 동작을 설정한다. 자세한 설명은 iLoader User's Manual의 '-async_prefetch' 옵션을 참고하기 바란다. + - SSL_ENABLE 대상 데이터베이스에 SSL 프로토콜로 접속할 것인지 여부를 지정한다. SSL_ENABLE = ON/OFF @@ -1074,10 +1101,11 @@ Altibase를 설치할 때, aexport.properties 파일은 \$ALTIBASE_HOME/conf에 SSL_CIPHER, SSL_VERIFY)로 명시할 수 있다. 각 프로퍼티의 역할은 aexport 접속 파라미터와 동일하므로 해당 절을 참조한다. SSL_ENABLE 프로퍼티 설정에 대한 예제는 SSL 프로퍼티 설정을 참고한다. -- ILOADER_GEOM = WKB - iLoader로 공간 데이터를 다운로드 할 때, 공간 데이터를 Well-Known Binary (WKB) - 포맷으로 처리하도록 지정하는 옵션이다. - run_il_out.sh 파일에 -geom WKB 옵션이 추가된다. + +- ILOADER_GEOM + ILOADER_GEOM = WKB + 공간 데이터를 Well-Known Binary (WKB) 포맷으로 추출한다. + ILOADER_GEOM =WKB를 설정하고 aexport를 수행하면, 생성된 run_il_out.sh 파일에 -geom WKB 옵션이 추가된 것을 확인 할 수 있다. From bedc7b7bd02af72629dacf99c2ead13fd987af9f Mon Sep 17 00:00:00 2001 From: Soyoon-Choi Date: Tue, 16 Jan 2024 14:23:29 +0900 Subject: [PATCH 19/25] Update Utilities Manual.md --- Manuals/Altibase_7.3/eng/Utilities Manual.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Manuals/Altibase_7.3/eng/Utilities Manual.md b/Manuals/Altibase_7.3/eng/Utilities Manual.md index 2375ed6ea..50e371cb3 100644 --- a/Manuals/Altibase_7.3/eng/Utilities Manual.md +++ b/Manuals/Altibase_7.3/eng/Utilities Manual.md @@ -818,8 +818,8 @@ When Altibase is installed, the \$ALTIBASE_HOME/conf directory does not actually SSL-related options can be enabled with the SSL_CA, SSL_CAPATH, SSL_CERT, SSL_KEY, SSL_CIPHER, SSL_VERIFY properties. For further information about these properties, please refer to Parameters. - ILOADER_GEOM - - This property specifies the processing of spatial data in Well-Known Binary (WKB) format when downloading spatial data with WKB iLoader. The '-geom WKB' option is added to the run_il_out.sh file. + ILOADER_GEOM = WKB + This property exports the spatial data in Well-Known Binary (WKB) format. The '-geom WKB' option is added to the run_il_out.sh file after adding 'ILOADER_GEOM = WKB' in aexport.properties and execution. From c59599ae6400a37dd59059fa50e5eb9e34517d56 Mon Sep 17 00:00:00 2001 From: Soyoon-Choi Date: Tue, 16 Jan 2024 17:08:39 +0900 Subject: [PATCH 20/25] Update Spatial SQL Reference.md --- .../Altibase_7.3/kor/Spatial SQL Reference.md | 18 +++++++++++------- 1 file changed, 11 insertions(+), 7 deletions(-) diff --git a/Manuals/Altibase_7.3/kor/Spatial SQL Reference.md b/Manuals/Altibase_7.3/kor/Spatial SQL Reference.md index 1728c8448..434dc17ea 100644 --- a/Manuals/Altibase_7.3/kor/Spatial SQL Reference.md +++ b/Manuals/Altibase_7.3/kor/Spatial SQL Reference.md @@ -7378,16 +7378,20 @@ else ### Altibase 제품 간 공간 데이터 마이그레이션 -Altibase 메타 버전 8.8.1부터 지원하는 공간 데이터 저장 포맷이 WKB에서 EWKB로 변경되었다. 사용자는 데이터 마이그레이션 수행 시 각 Altibase 제품의 메타 버전과 어떤 공간 데이터 저장 포맷을 지원하는 지 확인해야 한다. 메타 버전은 SYSTEM\_.SYS\_DATABASE_ 테이블에서 확인할 수 있다. +Altibase 메타 버전 8.8.1부터 공간 데이터 저장 포맷이 WKB에서 EWKB로 변경됨에 따라, Altibase 제품 간 공간 데이터 마이그레이션의 시나리오가 네 가지로 나뉘었다. -메타 버전에 따라 지원하는 공간 데이터 저장 포맷은 다음과 같다. +| 시나리오 | 데이터 마이그레이션 방법 | +| --------------------------------- | ------------------------------------------------------------ | +| 메타 버전이 모두 8.8.1 미만 | 기존과 동일한 방법으로 수행한다. | +| 메타 버전이 모두 8.8.1 이상 | 기존과 동일한 방법으로 수행한다. | +| 메타 버전 8.8.1 미만 → 8.8.1 이상 | 기존과 동일한 방법으로 수행한다. | +| 메타 버전 8.8.1 이상 → 8.8.1 미만 | 1. aexport.properties 파일에 ILOADER_GEOM = WKB 프로퍼티 구문을 추가한다.
2. aexport로 공간 데이터를 추출한다.
3. iLoader로 추출한 데이터 이관한다. 특정 테이블만 마이그레이션 하려면 iLoader에서 '-geom WKB' 옵션을 사용한다. | -- 메타 버전 8.8.1 미만: WKB 포맷 -- 메타 버전 8.8.1 이상: EWKB 포맷 - -Altibase 제품 간 공간 데이터 마이그레이션은 iLoader나 aexport를 사용한다. 이 유틸리티들은 공간 데이터 추출 시 각 메타 버전이 지원하는 포맷의 데이터 파일을 생성한다. 지원하는 공간 데이터 포맷이 같은 제품 간 데이터 마이그레이션 수행 방법은 기존과 같다. 또한, 메타 버전이 8.8.1 미만인 제품에서 8.8.1 이상인 제품으로 데이터를 이관하는 방법 또한 달라지지 않았다. 하지만, **메타 버전이 8.8.1 이상인 제품에서 8.8.1 미만인 제품으로 마이그레이션을 수행할 때에는 추가적인 작업이 필요하다**. +> [!TIP] +> +> Altibase의 메타 버전은 altibase -v 구문으로 확인할 수 있다. -WKB 포맷을 지원하는 Altibase는 EWKB 포맷 공간 데이터를 인식하지 못한다. 따라서 Altibase는 EWKB 포맷 공간 데이터를 WKB 포맷으로 추출하는 기능을 제공한다. 이 기능을 사용하기 위해서는 aexport.properties 파일에 'ILOADER_GEOM = WKB'를 추가해야 한다. 만약 특정 테이블만 마이그레이션 하려는 경우라면 iLoader에서 '-geom WKB' 옵션을 사용한다. 상세 내용은 iLoader와 aexport 매뉴얼을 참조한다. +aexport의 ILOADER_GEOM 프로퍼티와 iLoader의 '-geom WKB' 옵션은 EWKB 포맷을 WKB 포맷으로 처리하는 기능을 한다. 이 기능과 관련된 상세한 내용은 iLoader 매뉴얼과 aexport 매뉴얼을 참조한다. From 2139f840e2caa4fb10cd1acc3472d9bca71aaffb Mon Sep 17 00:00:00 2001 From: Soyoon-Choi <151510931+Soyoon-Choi@users.noreply.github.com> Date: Tue, 16 Jan 2024 17:40:16 +0900 Subject: [PATCH 21/25] Update Manuals/Altibase_7.3/kor/Spatial SQL Reference.md Co-authored-by: jina-altibase <43777901+jina-altibase@users.noreply.github.com> --- Manuals/Altibase_7.3/kor/Spatial SQL Reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Manuals/Altibase_7.3/kor/Spatial SQL Reference.md b/Manuals/Altibase_7.3/kor/Spatial SQL Reference.md index 434dc17ea..fae70774a 100644 --- a/Manuals/Altibase_7.3/kor/Spatial SQL Reference.md +++ b/Manuals/Altibase_7.3/kor/Spatial SQL Reference.md @@ -7385,7 +7385,7 @@ Altibase 메타 버전 8.8.1부터 공간 데이터 저장 포맷이 WKB에서 E | 메타 버전이 모두 8.8.1 미만 | 기존과 동일한 방법으로 수행한다. | | 메타 버전이 모두 8.8.1 이상 | 기존과 동일한 방법으로 수행한다. | | 메타 버전 8.8.1 미만 → 8.8.1 이상 | 기존과 동일한 방법으로 수행한다. | -| 메타 버전 8.8.1 이상 → 8.8.1 미만 | 1. aexport.properties 파일에 ILOADER_GEOM = WKB 프로퍼티 구문을 추가한다.
2. aexport로 공간 데이터를 추출한다.
3. iLoader로 추출한 데이터 이관한다. 특정 테이블만 마이그레이션 하려면 iLoader에서 '-geom WKB' 옵션을 사용한다. | +| 메타 버전 8.8.1 이상 → 8.8.1 미만 | 1. aexport.properties 파일에 ILOADER_GEOM = WKB 프로퍼티 구문을 추가한 다음, 기존과 동일한 방법으로 수행한다.
만약 특정 테이블만 마이그레이션 하려면 iLoader에서 '-geom WKB' 옵션을 사용한다. | > [!TIP] > From f9633526a6ab9c51f6fafc4688c3fb299525981b Mon Sep 17 00:00:00 2001 From: Soyoon-Choi Date: Wed, 17 Jan 2024 09:11:59 +0900 Subject: [PATCH 22/25] Update Spatial SQL Reference.md --- Manuals/Altibase_7.3/kor/Spatial SQL Reference.md | 14 ++++++-------- 1 file changed, 6 insertions(+), 8 deletions(-) diff --git a/Manuals/Altibase_7.3/kor/Spatial SQL Reference.md b/Manuals/Altibase_7.3/kor/Spatial SQL Reference.md index fae70774a..883c36b87 100644 --- a/Manuals/Altibase_7.3/kor/Spatial SQL Reference.md +++ b/Manuals/Altibase_7.3/kor/Spatial SQL Reference.md @@ -7378,27 +7378,25 @@ else ### Altibase 제품 간 공간 데이터 마이그레이션 -Altibase 메타 버전 8.8.1부터 공간 데이터 저장 포맷이 WKB에서 EWKB로 변경됨에 따라, Altibase 제품 간 공간 데이터 마이그레이션의 시나리오가 네 가지로 나뉘었다. +Altibase 메타 버전 8.8.1부터 공간 데이터 저장 포맷이 WKB에서 EWKB로 변경됨에 따라, Altibase 제품 간 공간 데이터 마이그레이션의 시나리오가 네 가지로 나뉘었다. + +메타 버전이 8.8.1 미만인 제품은 EWKB 포맷 공간 데이터를 인식하지 못하기 때문에, 상황에 따라 **EWKB 포맷 데이터를 WKB 포맷으로 추출해야 할 수도 있다.** Altibase는 aexport의 ILOADER_GEOM 프로퍼티와 iLoader의 '-geom WKB' 옵션을 이용하여 WKB 포맷으로 데이터를 추출할 수 있도록 했다. 이 기능과 관련된 상세한 내용은 각각 aexport 매뉴얼과 iLoader 매뉴얼을 참조한다. | 시나리오 | 데이터 마이그레이션 방법 | | --------------------------------- | ------------------------------------------------------------ | | 메타 버전이 모두 8.8.1 미만 | 기존과 동일한 방법으로 수행한다. | | 메타 버전이 모두 8.8.1 이상 | 기존과 동일한 방법으로 수행한다. | -| 메타 버전 8.8.1 미만 → 8.8.1 이상 | 기존과 동일한 방법으로 수행한다. | -| 메타 버전 8.8.1 이상 → 8.8.1 미만 | 1. aexport.properties 파일에 ILOADER_GEOM = WKB 프로퍼티 구문을 추가한 다음, 기존과 동일한 방법으로 수행한다.
만약 특정 테이블만 마이그레이션 하려면 iLoader에서 '-geom WKB' 옵션을 사용한다. | +| 메타 버전 8.8.1 미만 → 8.8.1 이상 | 기존과 동일한 방법으로 수행한다. (WKB 포맷 공간 데이터는 EWKB 포맷으로 자동 변환된다.) | +| 메타 버전 8.8.1 이상 → 8.8.1 미만 | aexport.properties 파일에 ILOADER_GEOM = WKB 프로퍼티 구문을 추가한 다음, 기존과 동일한 방법으로 수행한다.
만약 특정 테이블만 마이그레이션 하려면 iLoader에서 '-geom WKB' 옵션을 사용한다. | > [!TIP] -> > Altibase의 메타 버전은 altibase -v 구문으로 확인할 수 있다. -aexport의 ILOADER_GEOM 프로퍼티와 iLoader의 '-geom WKB' 옵션은 EWKB 포맷을 WKB 포맷으로 처리하는 기능을 한다. 이 기능과 관련된 상세한 내용은 iLoader 매뉴얼과 aexport 매뉴얼을 참조한다. - # A.부록: Spatial 칼럼의 제약사항 -이 부록은 Altibase에 Spatial 기능을 확장함에 따라 기존의 DBMS 기능 중 GEOEMTRY -칼럼에 대한 지원이 제한되는 부분을 기술한다. +이 부록은 Altibase에 Spatial 기능을 확장함에 따라 기존의 DBMS 기능 중 GEOEMTRY 칼럼에 대한 지원이 제한되는 부분을 기술한다. ### GEOMETRY 칼럼에 대한 제약 사항 From 67139c84499e42558cea988a3ced7789a96b7ed5 Mon Sep 17 00:00:00 2001 From: Soyoon-Choi Date: Wed, 17 Jan 2024 09:39:33 +0900 Subject: [PATCH 23/25] Update Spatial SQL Reference.md --- .../Altibase_7.3/eng/Spatial SQL Reference.md | 16 ++++++++++++---- 1 file changed, 12 insertions(+), 4 deletions(-) diff --git a/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md b/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md index 54d0fc5c2..607b5170a 100644 --- a/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md +++ b/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md @@ -6892,15 +6892,23 @@ else # 4. Spatial Data Migration -This section describes how to migrate spatial data between Atibase products or other vendor database products. +This section describes how to migrate spatial data between Altibase products or other vendor database products. ### Spatial Data Migration Between Altibase Products -For the migration of spatial data between Altibase products, iLoader and aexport can be utilized. Both utilities support spatial data types. +Altibase Meta version 8.8.1 introduced a change in the spatial data storage format from WKB to EWKB. This alteration divides the scenarios for spatial data migration among Altibase products into four categories. -One important consideration is the storage format for spatial data in Altibase. Based on the metadata version of the SYSTEM_.SYS_DATABASE_ table, versions below 8.8.1 support the WKB format, while versions 8.8.1 and above support the EWKB format. During migration, the extracted spatial data format follows the format of the Altibase where the spatial data is stored. Consequently, versions below 8.8.1 generate WKB format spatial data files, and versions 8.8.1 and above create EWKB format data files. +For products with a meta version below 8.8.1, which cannot recognize EWKB format spatial data, **there may be a need to export EWKB format data into WKB format** in certain situations. Altibase provides functionality for exporting data in WKB format using the ILOADER_GEOM property in aexport and the '-geom WKB' option in iLoader. For detailed information on this feature, please refer to the respective manuals for aexport and iLoader. -Spatial data in WKB format is automatically recognized and converted by Altibase supporting EWKB. However, Altibase supporting WKB cannot recognize spatial data in EWKB format. Therefore, when transferring EWKB format data to an Altibase supporting WKB, the option to extract the original data in WKB format must be used. During migration tasks, use the 'ILOADER_GEOM = WKB' option in the aexport.properties file for aexport, and for a single table operation, use the '-geom WKB' option in iLoader. For detailed information, please refer to the iLoader and aexport manuals. +| Scenario | Data Migration Process Change | +| -------------------------------------- | ------------------------------------------------------------ | +| All meta versions are below 8.8.1 | None | +| All meta versions are 8.8.1 or above | None | +| Meta version 8.8.1 below → 8.8.1 above | None (WKB format spatial data is automatically converted to EWKB format.) | +| Meta version 8.8.1 above → 8.8.1 below | Add the property statement ILOADER_GEOM = WKB to the aexport.properties file and then proceed as usual.
If users want to migrate only specific tables, use the '-geom WKB' option in iLoader. | + +> [!TIP] +> Users can check the Altibase Meta version using the 'altibase -v' command. # Appendix A. Limitations on the Use of Spatial Data in Altibase From 1dbea5f7163aa98853646d022be7e2247f8ecd15 Mon Sep 17 00:00:00 2001 From: "jina.kim" <> Date: Wed, 17 Jan 2024 15:43:28 +0900 Subject: [PATCH 24/25] Update Spatial SQL Reference.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 국문, A,B,C, D 안 제시합니다. 저는 C가 좋은것 같습니다. 의견 주세요~ --- .../Altibase_7.3/kor/Spatial SQL Reference.md | 136 ++++++++++++++++-- 1 file changed, 125 insertions(+), 11 deletions(-) diff --git a/Manuals/Altibase_7.3/kor/Spatial SQL Reference.md b/Manuals/Altibase_7.3/kor/Spatial SQL Reference.md index 883c36b87..5eabebe81 100644 --- a/Manuals/Altibase_7.3/kor/Spatial SQL Reference.md +++ b/Manuals/Altibase_7.3/kor/Spatial SQL Reference.md @@ -7372,27 +7372,141 @@ else } ``` -# 4. 공간 데이터 마이그레이션 +# 4. 공간 데이터 마이그레이션 (A) -본 장에서는 Altibase 또는 타 벤더 데이터베이스 제품과 공간 데이터 마이그레이션 하는 방법을 설명한다. +본 장에서는 Altibase 데이터베이스 간 공간 데이터 마이그레이션하는 방법을 설명한다. -### Altibase 제품 간 공간 데이터 마이그레이션 +### Altibase 데이터베이스 간 공간 데이터 마이그레이션 -Altibase 메타 버전 8.8.1부터 공간 데이터 저장 포맷이 WKB에서 EWKB로 변경됨에 따라, Altibase 제품 간 공간 데이터 마이그레이션의 시나리오가 네 가지로 나뉘었다. +공간 데이터 마이그레이션을 하기 위해 aexport와 iLoader를 사용한다. Altibase의 aexport와 iLoader는 공간 데이터를 지원하기때문에, 다른 데이터 타입과 동일한 방식으로 마이그레이션한다. 상세한 내용은 [**Utilities Manual**-aexport]() 와 [**iLoader User’s Manual**](https://github.com/ALTIBASE/Documents/blob/master/Manuals/Altibase_7.3/kor/iLoader%20User's%20Manual.md)를 참조한다. -메타 버전이 8.8.1 미만인 제품은 EWKB 포맷 공간 데이터를 인식하지 못하기 때문에, 상황에 따라 **EWKB 포맷 데이터를 WKB 포맷으로 추출해야 할 수도 있다.** Altibase는 aexport의 ILOADER_GEOM 프로퍼티와 iLoader의 '-geom WKB' 옵션을 이용하여 WKB 포맷으로 데이터를 추출할 수 있도록 했다. 이 기능과 관련된 상세한 내용은 각각 aexport 매뉴얼과 iLoader 매뉴얼을 참조한다. +> **주의** +> +> Altibase 메타 버전 8.8.1부터 공간 데이터 저장 포맷이 WKB에서 EWKB로 변경되었다. 이에 따라 메타버전이 8.8.1 이전의 WKB 포맷의 공간데이터를 메타버전이 8.8.1 이상의 데이터 베이스로 이관하는 경우, WKB 포맷 공간 데이터는 EWKB 포맷으로 자동 변환된다. +> +> 반면, 메타버전 8.8.1 미만의 Altibase는 EWKB 포맷 공간 데이터를 인식하지 못한다. 만약 메타버전이 8.8.1 이상인 데이터베이스에서 메타버전이 8.8.1 미만의 Altibase로 데이터를 이관해야 하는 경우는, 원본 데이터를 WKB 포맷으로 추출하고 진행해야 한다. + +#### aexport 수행시 WKB 포맷으로 데이터 추출하는 방법 + +aexport.properties 파일에 아래의 프로퍼티 설정을 추가한다. + +``` +ILOADER_GEOM_FORMAT = WKB +``` + +ILOADER_GEOM_FORMAT = WKB 프로퍼티 설정을 추가한 후 aexport를 수행하면, 생성되는 run_il_out.sh 파일에 -geom WKB 옵션이 추가된다. -| 시나리오 | 데이터 마이그레이션 방법 | -| --------------------------------- | ------------------------------------------------------------ | -| 메타 버전이 모두 8.8.1 미만 | 기존과 동일한 방법으로 수행한다. | -| 메타 버전이 모두 8.8.1 이상 | 기존과 동일한 방법으로 수행한다. | -| 메타 버전 8.8.1 미만 → 8.8.1 이상 | 기존과 동일한 방법으로 수행한다. (WKB 포맷 공간 데이터는 EWKB 포맷으로 자동 변환된다.) | -| 메타 버전 8.8.1 이상 → 8.8.1 미만 | aexport.properties 파일에 ILOADER_GEOM = WKB 프로퍼티 구문을 추가한 다음, 기존과 동일한 방법으로 수행한다.
만약 특정 테이블만 마이그레이션 하려면 iLoader에서 '-geom WKB' 옵션을 사용한다. | +#### iLoader 수행시 WKB 포맷으로 데이터를 이관하는 방법 + +iLoader를 이용하여 WKB 포맷으로 추출하는 방법 + +특정 테이블만 마이그레이션 하려는 경우는 iLoader의 '-geom WKB' 옵션을 사용한다. > [!TIP] > Altibase의 메타 버전은 altibase -v 구문으로 확인할 수 있다. +# 4. 공간 데이터 마이그레이션 (B) + +본 장에서는 Altibase 데이터베이스 간 공간 데이터 마이그레이션하는 방법을 설명한다. + +### Altibase 데이터베이스 간 공간 데이터 마이그레이션 + +공간 데이터 마이그레이션을 하기 위해 aexport와 iLoader를 사용한다. Altibase의 aexport와 iLoader는 공간 데이터를 지원하기때문에, 다른 데이터 타입과 동일한 방식으로 마이그레이션한다. 상세한 내용은 [**Utilities Manual**-aexport]() 와 [**iLoader User’s Manual**](https://github.com/ALTIBASE/Documents/blob/master/Manuals/Altibase_7.3/kor/iLoader%20User's%20Manual.md)를 참조한다. + +> **주의** +> +> Altibase 메타 버전 8.8.1부터 공간 데이터 저장 포맷이 WKB에서 EWKB로 변경되었다. 이에 따라 메타버전이 8.8.1 이전의 WKB 포맷의 공간데이터를 메타버전이 8.8.1 이상의 데이터 베이스로 이관하는 경우, WKB 포맷 공간 데이터는 EWKB 포맷으로 자동 변환된다. +> +> 반면, 메타버전 8.8.1 미만의 Altibase는 EWKB 포맷 공간 데이터를 인식하지 못한다. 만약 메타버전이 8.8.1 이상인 데이터베이스에서 메타버전이 8.8.1 미만의 Altibase로 데이터를 이관해야 하는 경우는, 원본 데이터를 WKB 포맷으로 추출하고 진행해야 한다. + +#### 원본 데이터를 WKB 포맷으로 추출하는 방법 + +##### aexport를 이용하여 WKB 포맷으로 추출하는 방법 + +aexport.properties 파일에 아래의 프로퍼티 설정을 추가한 다음 aexport를 수행한다. + +``` +ILOADER_GEOM_FORMAT = WKB +``` + +ILOADER_GEOM_FORMAT = WKB 프로퍼티 설정을 추가한 후 aexport를 수행하면, 생성되는 run_il_out.sh 파일에 -geom WKB 옵션이 추가된다. + +##### iLoader를 이용하여 WKB 포맷으로 추출하는 방법 + +특정 테이블만 마이그레이션 하려는 경우는 iLoader의 '-geom WKB' 옵션을 사용한다. + +>[!TIP] +>Altibase의 메타 버전은 altibase -v 구문으로 확인할 수 있다. + + + +# 4. 공간 데이터 마이그레이션 (C) + +본 장에서는 Altibase 데이터베이스 간 공간 데이터 마이그레이션하는 방법을 설명한다. + +### Altibase 데이터베이스 간 공간 데이터 마이그레이션 + +공간 데이터 마이그레이션을 하기 위해 aexport와 iLoader를 사용한다. Altibase의 aexport와 iLoader는 공간 데이터를 지원하기때문에, 다른 데이터 타입과 동일한 방식으로 마이그레이션한다. 상세한 내용은 [**Utilities Manual**-aexport]() 와 [**iLoader User’s Manual**](https://github.com/ALTIBASE/Documents/blob/master/Manuals/Altibase_7.3/kor/iLoader%20User's%20Manual.md)를 참조한다. + + Altibase 메타 버전 8.8.1부터 공간 데이터 저장 포맷이 EWKB로 변경되었다. (Altibase 메타 버전 8.8.1 이하의 공간 데이터 저장 포맷은 WKB이다.) 만약, 메타버전이 8.8.1 이상인 데이터베이스에서 메타버전이 8.8.1 미만의 Altibase로 데이터를 이관해야 하는 경우는, 아래의 "원본 데이터를 WKB 포맷으로 추출하는 방법"을 참고한다. + +> 참고 +> +> 메타버전이 8.8.1 이전의 WKB 포맷의 공간 데이터를 메타버전이 8.8.1 이상의 데이터베이스로 이관하는 경우, WKB 포맷 공간 데이터는 EWKB 포맷으로 자동 변환된다. +> + +#### 원본 데이터를 WKB 포맷으로 추출하는 방법 + +##### aexport를 이용하여 WKB 포맷으로 추출하는 방법 + +aexport.properties 파일에 아래의 프로퍼티 설정을 추가한 다음 aexport를 수행한다. + +``` +ILOADER_GEOM_FORMAT = WKB +``` + +ILOADER_GEOM_FORMAT = WKB 프로퍼티 설정을 추가한 후 aexport를 수행하면, 생성되는 run_il_out.sh 파일에 -geom WKB 옵션이 추가된다. + +##### iLoader를 이용하여 WKB 포맷으로 추출하는 방법 + +특정 테이블만 마이그레이션 하려는 경우는 iLoader의 '-geom WKB' 옵션을 사용한다. + +>[!TIP] +>Altibase의 메타 버전은 altibase -v 구문으로 확인할 수 있다. + +# 4. 공간 데이터 마이그레이션 (D) + +본 장에서는 Altibase 데이터베이스 간 공간 데이터 마이그레이션하는 방법을 설명한다. + +### Altibase 데이터베이스 간 공간 데이터 마이그레이션 + +공간 데이터 마이그레이션을 하기 위해 aexport와 iLoader를 사용한다. Altibase의 aexport와 iLoader는 공간 데이터를 지원하기때문에, 다른 데이터 타입과 동일한 방식으로 마이그레이션한다. 상세한 내용은 [**Utilities Manual**-aexport]() 와 [**iLoader User’s Manual**](https://github.com/ALTIBASE/Documents/blob/master/Manuals/Altibase_7.3/kor/iLoader%20User's%20Manual.md)를 참조한다. + +마이그레이션 수행시 추출되는 공간 데이터의 포맷은 공간 데이터가 저장된 Altibase가 지원하는 포맷을 따르는데, Altibase 메타 버전 8.8.1 부터 공간 데이터 저장 포맷이 EWKB로 변경되었다. 이로 인해 하위버전에서 상위버전으로의 마이그레이션 방법에는 변경이 없지만, 상위 버전에서 하위버전으로의 마이그레이션은 아래의 주의 사항을 참고해야 한다. + +> 주의 +> +> 메타버전 8.8.1 미만의 Altibase는 EWKB 포맷 공간 데이터를 인식하지 못한다. 메타버전이 8.8.1 이상인 데이터베이스에서 메타버전이 8.8.1 미만의 Altibase로 데이터를 이관해야 하는 경우는, 아래의 "원본 데이터를 WKB 포맷으로 추출하는 방법"을 참고한다. + +> 참고 +> +> 메타버전이 8.8.1 이전의 WKB 포맷의 공간데이터를 메타버전이 8.8.1 이상의 데이터 베이스로 이관하는 경우, WKB 포맷 공간 데이터는 EWKB 포맷으로 자동 변환된다. + +#### 원본 데이터를 WKB 포맷으로 추출하는 방법 + +##### aexport를 이용하여 WKB 포맷으로 추출하는 방법 + +aexport.properties 파일에 아래의 프로퍼티 설정을 추가한 다음 aexport를 수행한다. + +``` +ILOADER_GEOM_FORMAT = WKB +``` + +ILOADER_GEOM_FORMAT = WKB 프로퍼티 설정을 추가한 후 aexport를 수행하면, 생성되는 run_il_out.sh 파일에 -geom WKB 옵션이 추가된다. + +##### iLoader를 이용하여 WKB 포맷으로 추출하는 방법 +특정 테이블만 마이그레이션 하려는 경우는 iLoader의 '-geom WKB' 옵션을 사용한다. # A.부록: Spatial 칼럼의 제약사항 From 486e410bdbd2a5bc4ac4a84c9564b6515201e69a Mon Sep 17 00:00:00 2001 From: jina-altibase <43777901+jina-altibase@users.noreply.github.com> Date: Thu, 17 Apr 2025 18:23:19 +0900 Subject: [PATCH 25/25] Update Manuals/Altibase_7.3/eng/Spatial SQL Reference.md Co-authored-by: Soyoon-Choi <151510931+Soyoon-Choi@users.noreply.github.com> --- Manuals/Altibase_7.3/eng/Spatial SQL Reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md b/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md index 607b5170a..d535c1582 100644 --- a/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md +++ b/Manuals/Altibase_7.3/eng/Spatial SQL Reference.md @@ -6892,7 +6892,7 @@ else # 4. Spatial Data Migration -This section describes how to migrate spatial data between Altibase products or other vendor database products. +This section describes how to migrate spatial data between Altibase servers or Altibase and the other vendor database. ### Spatial Data Migration Between Altibase Products