2.2.3.13.1 rdsConnectionString

  • Article

The rdsConnectionString specifies:<32>

  • The data store with which the RDS Transport Protocol server MUST communicate to process the request.

  • The attributes of the connection.

The syntax of rdsConnectionString is defined as follows.

 rdsConnectionString = rdsGeneralConnectionString
            
 rdsGeneralConnectionString = KeyValuePair *(";" KeyValuePair) [";"]
            
 KeyValuePair = (Key "=" Value / QuotedValue)
     / DataSourceKV / UserIdKV / PasswordKV
            
 QuotedValue = ("'" Value "'") / (DQUOTE Value DQUOTE)
            
 DataSourceKV = "DataSource=" DataSource 
     / ("'" DataSource "'") / (DQUOTE DataSource DQUOTE)
            
 DataSource = DataSourceNetwork / DataSourceFile / DataSourceURL
            
 DataSourceNetwork = MachineName [ "\" ServerInstance]
 MachineName = "(local)" / "(localhost)" / "." / ServerNetworkName
            
 ServerNetworkName = ConnectionStringIdentifier
            
 ServerInstance = ConnectionStringIdentifier
            
 DataSourceFile = ConnectionStringIdentifier
            
 DataSourceURL = DataSourceScheme ":" DataSourceSSP
            
 DataSourceScheme = *(ALPHA / "+" / "." / "-")
            
 DataSourceSSP = *(ALPHA / DIGIT / "+" / "%" / "/" / "\" /
     "$" / "-" / "_" / "." / "!" / "*" / "'" / "(" / ")" / ",")
            
 UserIdKV = "User Id=" UserId / 
     ("'" UserId "'") / (DQUOTE UserId DQUOTE)
            
 UserId = ALPHA / "_" *(ALPHA / DIGIT / "@" / "$" / "#" / "_")
            
 PasswordKV = "Password=" Password /
     ("'" Password "'") / (DQUOTE Password DQUOTE)
            
 Key = ConnectionStringIdentifier
            
 Value = ConnectionStringIdentifier
            
 Password = Value
            
 ConnectionStringIdentifier = *ASCIICHAR / QuotedValue

  • ConnectionStringIdentifier

    This field MUST NOT contain any of the characters "[]{}(),;?*!@", unless it is an instance of QuotedValue.

  • DataSource

    • The DataSource uniquely specifies a data store in one of three ways:

      • DataSourceNetwork - A database on the network.

      • DataSourceFile - A file on the RDS Transport Protocol server or the network.

      • DataSourceURL - A URL (as specified in [RFC1738]), which may point to a server, a server/instance combination, a file, or a web resource.

    • DataSourceNetwork

      When any of the special keywords "(local)", "(localhost)", and "." appear at the beginning of the DataSourceNetwork field, they specify that the data store is located on the same machine as the RDS Transport Protocol server.

    • DataSourceURL

      RDS Transport Protocol servers MUST allow the "\" character to be used in the scheme-specific part of the DataSourceURL. RDS Transport Protocol servers MAY<33> allow the use of additional schemes beyond those specified in [RFC1738].

    • ServerNetworkName

      A valid TCP/IP address or name of the machine that hosts the data store.

    • ServerInstance

      A string identifier that distinguishes between multiple data stores hosted on the same machine.

  • UserId

    Specifies the user name. The data store can specify and enforce further restrictions on the range of valid values for this field.

  • Password

    Specifies the user password. The data store may specify and enforce further restrictions on the range of valid values for this field.