clarify the use of the fail_if_no_mapping switch and minor cleanup

This commit is contained in:
Pierangelo Masarati 2004-04-14 13:10:00 +00:00
parent ec34062ed4
commit 8bf68bc796

View File

@ -97,8 +97,7 @@ The default is
.B "DELETE FROM ldap_entries WHERE id=?" .B "DELETE FROM ldap_entries WHERE id=?"
These four options specify SQL query templates for loading schema mapping These four options specify SQL query templates for loading schema mapping
metainformation, metainformation, adding and deleting entries to ldap_entries, etc.
adding and deleting entries to ldap_entries, etc.
All these and subtree_cond should have the given default values. All these and subtree_cond should have the given default values.
For the current value it is recommended to look at the sources, For the current value it is recommended to look at the sources,
or in the log output when slapd starts with "-d 5" or greater. or in the log output when slapd starts with "-d 5" or greater.
@ -114,7 +113,7 @@ Set this directive to
if if
.B upper_func .B upper_func
needs an explicit cast when applied to literal strings. The form needs an explicit cast when applied to literal strings. The form
.B cast (<arg> as varchar(<max DN length>)) .B CAST (<arg> AS VARCHAR(<max DN length>))
is used, where is used, where
.B <max DN length> .B <max DN length>
is builtin. is builtin.
@ -130,11 +129,11 @@ to be used to concatenate strings. The
MUST contain two question marks, '?', that will be replaced MUST contain two question marks, '?', that will be replaced
by the two strings that must be concatenated. The default value is by the two strings that must be concatenated. The default value is
.BR "CONCAT(?,?)"; .BR "CONCAT(?,?)";
a form that is known to be highly portable is a form that is known to be highly portable (IBM db2, PostgreSQL) is
.BR "?||?", .BR "?||?",
but an explicit cast may be required when operating on literal strings: but an explicit cast may be required when operating on literal strings:
.BR "cast(?||? as varchar(<length>))". .BR "CAST(?||? AS VARCHAR(<length>))".
On some RDBMSes the form On some RDBMSes (IBM db2, MSSQL) the form
.B "?+?" .B "?+?"
is known to work. is known to work.
Carefully check the documentation of your RDBMS or stay with the examples Carefully check the documentation of your RDBMS or stay with the examples
@ -164,9 +163,20 @@ and may change in future releases.
.B fail_if_no_mapping { yes | no } .B fail_if_no_mapping { yes | no }
When set to When set to
.B yes .B yes
it forces write operations to fail if no appropriate mapping between LDAP it forces
attributes and SQL data is available. The default behavior is to ignore .I attribute
those changes that cannot be mapped correctly. write operations to fail if no appropriate mapping between LDAP attributes
and SQL data is available.
The default behavior is to ignore those changes that cannot be mapped
correctly.
It has no impact on objectClass mapping, i.e. if the
.I structuralObjectClass
of an entry cannot be mapped to SQL by looking up its name
in ldap_oc_mappings, an
.I add
operation will fail regardless of the
.B fail_if_no_mapping
switch; see section "METAINFORMATION USED" for details.
This is This is
.B experimental .B experimental
and may change in future releases. and may change in future releases.
@ -183,7 +193,7 @@ generating sample database for Oracle, MS SQL Server, mySQL and more
The first thing that one must arrange is what set of LDAP The first thing that one must arrange is what set of LDAP
object classes can present your RDBMS information. object classes can present your RDBMS information.
.LP .LP
The easiest way is to create an objectclass for each entity you had in The easiest way is to create an objectClass for each entity you had in
ER-diagram when designing your relational schema. ER-diagram when designing your relational schema.
Any relational schema, no matter how normalized it is, was designed Any relational schema, no matter how normalized it is, was designed
after some model of your application's domain (for instance, accounts, after some model of your application's domain (for instance, accounts,