Teradata Aster Client 6.22 Release Notes

Transcription

1 Teradata Aster Client 6.22 Release Notes Product ID: B K Released: May, 2017 Aster Client version: 6.22 Summary This document describes the new features and enhancements in the AC 6.22 and AC releases of the Aster Client software. This document also provides notifications about software behavior and lists open and fixed issues. The AC release of the Aster Client software introduces this new feature: Using Single Sign-on (SSO) with Aster Loader Tool and Aster Export Tool The AC 6.22 release of the Aster Client software introduces these new features: Teradata Aster R Package Functions Open Source R Client Installation Note: The AC release includes changes to the Teradata Aster R package only and uses the other required Client software components from the AC 6.20 release. All required versions of the Aster R and Client software are packaged together in a single downloadable file (see Getting and Installing Aster Client). This is only the case for AC , not for AC (which is packaged correctly). Contents Summary Contents What's New? Who Should Install this Release? Aster Client 6.22 Release Notes 1

2 What's New? Aster Client Library Information Documentation Library Changes Terminology Use Reference Getting and Installing Aster Client Notifications Known Issues Fixed Issues Naming Convention for Teradata Aster Releases End-of-Life and Deprecation Notices Contacting Teradata Global Technical Support (GTS) Third Party Licenses About This Document What's New? Aster Client Features Teradata Aster R Features Using Single Sign-on (SSO) with Aster Loader Tool and Aster Export Tool This release includes SSO support for Aster Loader Tool and Aster Export Tool. Teradata Aster R Package Functions This release introduces new functions to the Teradata Aster R Package. These new functions include: Basic Statistical Functions R Map Reduce Runner Functions Parallel Statistics and Big Data Analytics Functions ta.summarise(), ta.summarise.each() ta.source() ta.hmmunsupervisedlearner(), ta.hmmsupervisedlearner(), ta.hmmevaluator(), ta.hmmdecoder(), ta.sparsesvmtrainer(), ta.sparsesvmpredictor(), ta.svmmodelprinter(),ta.coxph(), ta.coxpredict(), ta.coxsurvfit(), ta.dtw(), ta.dwt2d(), ta.outlierfilter(), ta.jsonparser(), ta.apachelog.parser(), ta.xmlparser(), ta.ngram(), ta.tf(), ta.tfidf(), ta.text.tokenizer(), ta.texttagging(), ta.naivebayestextclassifier.trainer(), ta.naivebayestextclassifier.predict(), ta.pack(), ta.unpack() For more information, refer to the Aster R User Guide. Aster Client 6.22 Release Notes 2

3 Who Should Install this Release? Open Source R Client Installation This release includes open source R client installation instructions for Unix SLES workstations or edge nodes for SLES-11 SP2. Who Should Install this Release? All new Aster installations that connect to an Aster Instance or Aster Database using the new clients should install this version. Customers using earlier versions of the Aster clients can still connect to Aster, but may want to transition to this version of the client in order to take advantage of the new features. Aster Client Library Information To obtain the latest documentation supporting this release, go to The Aster Client documentation includes: Teradata Aster Client 6.22 Release Notes Teradata Aster Client Guide 6.22 Documentation Library Changes Teradata Aster Execution Engine Drivers and Utilities Matrix This document has been removed from the AC 6.22 Documentation Library. For information on compatibility between releases of Aster Execution Engine and Aster Client, refer to Teradata Aster Execution Engine Release Notes For information on Teradata tools compatibility, refer to Teradata Aster Execution Engine Release Notes For information on Aster utilities and Aster client drivers, refer to Teradata Aster Client Guide For information on Hadoop compatibility, refer to Teradata Aster Installation Guide Terminology Use Reference For Teradata Aster Execution Engine software installations Installation of the Aster Execution Engine Base Module software package on a Hadoop cluster where the Hadoop cluster is running a certified operating system (OS) and Hadoop distribution combination results in an Aster instance in the Hadoop cluster. And in this case, references to Aster Database in this document refer to the Aster instance. Aster Client 6.22 Release Notes 3

4 Getting and Installing Aster Client For Teradata Aster Database software installations If the system is running a supported version of the Teradata Aster Database software on dedicated hardware (for example, only the Aster Analytics application), references to Aster Database in this document refer to the Aster Database software that is running on the Aster cluster with a supported Teradata Aster Appliance or commodity hardware platform. Getting and Installing Aster Client You can download this release of the Aster Client for all supported platforms from: The AC release includes changes to the Teradata Aster R package only and uses the other required Client software components from the AC 6.20 release. All required versions of the Aster R and Client software are included in the downloadable file.this is only the case for AC , not for AC (which is packaged correctly). Notifications ncluster_loader Aster Client 6.22 has the following compatibility with RStudio: Windows 64-bit and 32-bit platforms: RStudio version Linux 64-bit platforms: RStudio version , which is available for download at Linux 32-bit platforms: RStudio is not supported. Note: R Console is supported for this platform. Aster Execution Engine does not support underlying features used by some optional functionality of the ncluster_loader. Specifically, Aster Execution Engine has no loader node and does not allow parent/child partitioning via inheritance. By extension, Aster Execution Engine also does not allow custom error logging tables, since custom error logging tables are required to be created using parent/child partitioning via inheritance. The affected ncluster_loader optional flags are --el-table, --el-errfile, --el-schema, --auto-partitioning, --loader, and --force-loader. Teradata recommends these guidelines when using these optional flags with ncluster_loader and the Aster Execution Engine: Do not use the --el-schema command line flag, because its default value is the only allowed value. Unless you wish to use the command line flag --el-errfile, do not use the --el-table command line flag, since its default value is the only allowed value. To use the command line flag --el-errfile, you must set the command line argument --el-table or the corresponding flag to one of these values "nc_errortable_part" or Aster Client 6.22 Release Notes 4

5 Notifications Teradata Aster R "nc_errortable_repl" depending on whether the target table is distributed or replicated respectively. Do not use the command line argument --auto-partition, since Aster Execution Engine does not allow parent/child partitioning via inheritance. Because Aster Execution Engine does not have loader node, do not use the command line arguments --force-loader and --loader. Instead, simply use the --hostname command line argument to direct ncluster_loader to the queen node. Note that these command line flags have corresponding map file flags, and these guideline recommendations apply to the map file flags as well. An additional step is necessary to set up Teradata Aster R on a cluster for AX The instructions can be found in the Teradata Aster R Orange Book, located at: Add ODBCSYSINI=/root to the /opt/aster/third-party/r/usr/lib64/r/etc/renviron file after you update the /opt/aster/third-party/r/usr/lib64/r/etc/ldpaths file (see section B.4.3 in the Teradata Aster R Orange Book). Installed R scripts in Aster are removed on a soft restart operation. The ncli database ddl_checkpoint_all command will not restore the installed R scripts. You must reinstall scripts and tables. The ta.create function supports creation of dimension, fact, or analytic tables. With the AX release, tables created are always analytic regardless of the tabletype argument value. Since only a Database Administrator can create a schema in AX , by default, public schema is used as a temporary schema for the given session. If a server restart occurs, the temporary schema (other than public) will be deleted if it is not persisted using the ncli database ddl_checkpoint_all command. A db_superuser can create different temporary schemas and allocate them to different users by giving them full access on the schema. The temporary schemas can be persisted by using the ncli database ddl_checkpoint_all command. To create a new connection, perform a ta.connect from the R client after the server restarts. You cannot use user defined tables for error logging in ta.load.csv and ta.push functions. Only the system error logging table can be used for elschema = "" and eltable = "" arguments. Aster Client 6.22 Release Notes 5

6 Known Issues Known Issues \install file on a schema that has a space (" ") does not work Issue ID: BH Details: \install file on a schema that has a space (" ") does not work with the AC ACT client. AFS: ChmodParser doesn't work on Win32, Solarisx86 or Solaris Sparc Issue ID: BH-3275 Details: The ChmodParser does not work in the ACT AFS Shell on these platforms: Windows 32-bit Solaris x86 Solaris SPARC auto-analyze and vacuum-table settings for Loader Connection Manager not listed in loader configuration file Issue ID: CLNT-1912 Details: The auto-analyze and vacuum-table options are not set in the loader configuration file because they are not defined within the configuration file of the ncluster_loader. In-database R functions with FUN.upload = script and utility functions will not work within RStudio on Linux Issue ID: CLNT-2635 Details: In-database R functions with the FUN.upload = script option and utility functions, such as ta.install.scripts and ta.install.files, will not work within RStudio on Linux due to compatibility issues between RStudio and the Aster ODBC driver. Workaround: Install scripts from RConsole using the ta.install.scripts or ta.install.files functions or use the ACT client to install the scripts on the cluster. In- Database R Function Runners can then be used without specifying the FUN.upload = script argument. ACT help messages show syntax that is obsolete Issue: BH Details: The Aster Execution Engine does not support compressed tables or indexes. When COMPRESS is used with any of the statements above, it is ignored and the table or index will not be compressed. Consequently, when NOCOMPRESS is used with ALTER statements, it will also have no effect. The only types of persistence the Aster Execution Engine supports are TEMPORARY and ANALYTIC. Parent/child partitioning via inheritance is not allowed with TEMPORARY or ANALYTIC tables. The INHERITS clause of CREATE TABLE is used to request parent/child Aster Client 6.22 Release Notes 6

7 Fixed Issues partitioning via inheritance. The INHERIT and NO INHERIT clauses of ALTER TABLE are used to establish or remove parent/child partitioning via inheritance. When INHERITS or INHERIT are used in Aster Execution Engine, an error will be raised as shown: ERROR: inheritance with analytic tables is not supported. ERROR: inheritance with temporary tables is not supported. Since there can be no parent/child partitioning via inheritance, when NO INHERIT is used with the ALTER TABLE statement, an error will be raised: ERROR: relation <parent table>" is not a parent of relation <child table>" In Aster Execution Engine, tables are created as ANALYTIC by default. Columnar storage is not supported with ANALYTIC tables. When the STORAGE COLUMN clause is used with CREATE TABLE or ALTER statements and the table is an ANALYTIC table, the clause is ignored and Row storage is used instead. Fixed Issues FIXED: %in% throws invalid input syntax error for large numeric values Issue ID: CLNT-2234 Using %in% throws a syntax error when the value is large. FIXED: ta.max doesn t work on date columns Issue ID: CLNT-1826 Aster is unable to perform database max, min, and mean operations on tadf virtual data frames. FIXED: %in% expression does not consider NA values like native R Issue ID: CLNT-2235 Native R can accept NA values and produces a row of that value. Aster R does not produce this row. The workaround is to use the condition to obtain the correct result. FIXED: R:R console might not respond if Aster Database QoS=0 Issue ID: CLNT-2137 Sometimes disk space will be insufficient if the user inserts a large amount of data into the database from R and QoS will become zero. At this point, the R console is hung and the user must kill the R console process directly. This is a known limitation of RODBC. FIXED: ta.summary() fails on a table with 500 million rows Issue ID: CLNT-1948 The ta.summary() function fails on a table with over 500 million rows. It is recommended that you set numeric.col=true for large data sets. Aster Client 6.22 Release Notes 7

8 Naming Convention for Teradata Aster Releases Naming Convention for Teradata Aster Releases Teradata Aster release naming convention is: AX: Aster Execution Engine AD: Aster Database AC: Aster Client AA: Aster Analytics Foundation AP: Aster AppCenter Release numbering for all of the above will follow this convention: XX.YY.ZZ.nn where: XX is a major release. YY is a minor release. ZZ is a maintenance release. nn is a efix or hotpatch. We use this terminology: major release: Major releases of Aster software typically introduce new features. minor release: Point releases of Aster software typically provide feature enhancements and bug fixes. A point release may also introduce new features. maintenance release: Maintenance releases of Aster software typically provide only bug fixes. efix or hotpatch: Hotpatch release are introduced to address customer issues of an urgent nature. End-of-Life and Deprecation Notices There are no End-of-Life or Deprecation Notices for the Aster Client 6.22 release. Aster Client 6.22 Release Notes 8

9 Contacting Teradata Global Technical Support (GTS) Contacting Teradata Global Technical Support (GTS) For assistance and updated documentation, contact Teradata Global Technical Support (GTS): Support Portal: International: US Customers: 877-MyT-Data ( ) Third Party Licenses Your Aster installation includes a number of open source products. The license text for these products is available in the Aster Instance User Guide, the Aster Database User Guide, and in the chapter Licenses and on your Aster queen, as a set of text files in the /home/beehive/ licenses directory. About This Document Version History This document was updated in May 2017 as part of the Aster Client 6.22 release. Table 1-1: Version History Table Release Product ID Date AC 6.22 B K May 2017 AC 6.22 B K November 2016 AC 6.22 B K July 2016 AC 6.22 B K June 2016 Copyright and Legal Statements The product or products described in this book are licensed products of Teradata Corporation or its affiliates. Teradata, Applications-Within, Aster, BYNET, Claraview, DecisionCast, Gridscale, QueryGrid, SQL-MapReduce, Teradata Decision Experts, "Teradata Labs" logo, Teradata ServiceConnect, Teradata Source Experts, WebAnalyst, and Xkoto are trademarks or registered trademarks of Teradata Corporation or its affiliates in the United States and other countries. Adaptec and SCSISelect are trademarks or registered trademarks of Adaptec, Inc. Amazon Web Services, AWS, Amazon Elastic Compute Cloud, Amazon EC2, Amazon Simple Storage Service, Amazon S3, AWS CloudFormation, and AWS Marketplace are trademarks of Amazon.com, Inc. or its affiliates in the United States and/or other countries. AMD Opteron and Opteron are trademarks of Advanced Micro Devices, Inc. Apache, Apache Avro, Apache Hadoop, Apache Hive, Hadoop, and the yellow elephant logo are either registered trademarks or trademarks of the Apache Software Foundation in the United States and/or other countries. Apple, Mac, and OS X all are registered trademarks of Apple Inc. Aster Client 6.22 Release Notes 9

10 About This Document Axeda is a registered trademark of Axeda Corporation. Axeda Agents, Axeda Applications, Axeda Policy Manager, Axeda Enterprise, Axeda Access, Axeda Software Management, Axeda Service, Axeda ServiceLink, and Firewall-Friendly are trademarks and Maximum Results and Maximum Support are servicemarks of Axeda Corporation. CENTOS is a trademark of Red Hat, Inc., registered in the U.S. and other countries. Cloudera and CDH are trademarks or registered trademarks of Cloudera Inc. in the United States, and in jurisdictions throughout the world. Data Domain, EMC, PowerPath, SRDF, and Symmetrix are either registered trademarks or trademarks of EMC Corporation in the United States and/or other countries. GoldenGate is a trademark of Oracle. Hewlett-Packard and HP are registered trademarks of Hewlett-Packard Company. Hortonworks, the Hortonworks logo and other Hortonworks trademarks are trademarks of Hortonworks Inc. in the United States and other countries. Intel, Pentium, and XEON are registered trademarks of Intel Corporation. IBM, CICS, RACF, Tivoli, and z/os are registered trademarks of International Business Machines Corporation. Linux is a registered trademark of Linus Torvalds. LSI is a registered trademark of LSI Corporation. Microsoft, Active Directory, Windows, Windows NT, and Windows Server are registered trademarks of Microsoft Corporation in the United States and other countries. NetVault is a trademark of Quest Software, Inc. Novell and SUSE are registered trademarks of Novell, Inc., in the United States and other countries. Oracle, Java, and Solaris are registered trademarks of Oracle and/or its affiliates. QLogic and SANbox are trademarks or registered trademarks of QLogic Corporation. Quantum and the Quantum logo are trademarks of Quantum Corporation, registered in the U.S.A. and other countries. Red Hat is a trademark of Red Hat, Inc., registered in the U.S. and other countries. Used under license. SAP is the trademark or registered trademark of SAP AG in Germany and in several other countries. SAS and SAS/C are trademarks or registered trademarks of SAS Institute Inc. SPARC is a registered trademark of SPARC International, Inc. Unicode is a registered trademark of Unicode, Inc. in the United States and other countries. UNIX is a registered trademark of The Open Group in the United States and other countries. Veritas, the Veritas Logo and NetBackup are trademarks or registered trademarks of Veritas Technologies LLC or its affiliates in the U.S. and other countries. Other product and company names mentioned herein may be the trademarks of their respective owners. THE INFORMATION CONTAINED IN THIS DOCUMENT IS PROVIDED ON AN "AS-IS" BASIS, WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES, SO THE ABOVE EXCLUSION MAY NOT APPLY TO YOU. IN NO EVENT WILL TERADATA CORPORATION BE LIABLE FOR ANY INDIRECT, DIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, INCLUDING LOST PROFITS OR LOST SAVINGS, EVEN IF EXPRESSLY ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. The information contained in this document may contain references or cross-references to features, functions, products, or services that are not announced or available in your country. Such references do not imply that Teradata Corporation intends to announce such features, functions, products, or services in your country. Please consult your local Teradata Corporation representative for those features, functions, products, or services available in your country. Information contained in this document may contain technical inaccuracies or typographical errors. Information may be changed or updated without notice. Teradata Corporation may also make improvements or changes in the products or services described in this information at any time without notice. To maintain the quality of our products and services, we would like your comments on the accuracy, clarity, organization, and value of this document. Please teradata-books@lists.teradata.com. Any comments or materials (collectively referred to as "Feedback") sent to Teradata Corporation will be deemed non-confidential. Teradata Corporation will have no obligation of any kind with respect to Feedback and will be free to use, reproduce, disclose, exhibit, display, transform, create derivative works of, and distribute the Feedback and derivative works thereof without limitation on a royalty-free basis. Further, Teradata Corporation will be free to use any ideas, concepts, know-how, or techniques contained in such Feedback for any purpose whatsoever, including developing, manufacturing, or marketing products or services incorporating Feedback. Copyright by Teradata. All Rights Reserved. Aster Client 6.22 Release Notes 10