====== Data Resource - Data Selector ======

===== About =====
A ''data selector'' is a [[data_uri|data uri]] expression that permits to select:
  * [[content|data resources]] (file, table,...)
  * or [[container|container resources]] (directory, schema, ...)

<note>
If you are new to the concept of data selector, we encourage you to take a look at this page: [[howto:getting_started:4_select_data_resources]]
</note>



===== Syntax =====

This syntax select [[docs:resource:resource|data resources]] listed in the [[docs:connection:connection|connection]]

<code bash>
globPath[@connection]
</code>
where:
  * ''connection'' is the [[docs:connection:name|name of a connection]]
  * ''globPath'' is a path composed  of [[docs:common:globbing|glob pattern]] separated by a [[#separator_syntax_support|path separator]]

<note tip>
You can reference each wildcard character in a [[target_uri|target data uri]] to define the target resources.
</note>





==== File System ====

For a [[docs:system:file|file system]], the following special character are supported in the path:
  * ''/'' for the separator
  * ''.'' to design the current working directory
  * ''..'' to design the parent directory of the current working directory

Example:
  * Absolute
<code bash>
# Linux
/globPatternForDirectory/globPatternForFile@fileSystemConnection
# Windows
C:\globPatternForDirectory\globPatternForFile@fileSystemConnection
</code>
  * Relative
<code bash>
# Linux (and Windows)
../globPatternForDirectory/globPatternForFile@fileSystemConnection
# Windows form works also but is not recommended
..\globPatternForDirectory\globPatternForFile@fileSystemConnection
</code>



==== Sql Database ====

For a [[docs:system:database|sql database]], the following characters are supported in the path:
  * ''.'', for the path name separator
  * ''/'' to design the current schema
  * ''%%//%%'' to design the parent (schema, catalog)

<code bash>
# an sql object pattern
[catalogueGlobPattern][.schemaNamePattern.]objectNamePattern@database
# a sql schema pattern
//.schemaNamePattern
# a sql catalog pattern
//.//.schemaNamePattern
</code>

==== Web ====
For a [[docs:system:http|web system]], ''Tabulify'' supports passing directly an [[URI|URI/URL]] as a data selector.

<note important>
Only in [[docs:common:bash|bash based terminal]], see [[docs:common:bash#why_do_we_recommend_bash|why]]
</note>


<unit>
<code bash>
tabli data info "https://en.wikipedia.org/w/api.php?action=query&titles=SQL&format=xml&prop=description"
</code>
<console>
Information about the data resource (https://en.wikipedia.org/w/api.php?action=query&titles=SQL&format=xml&prop=description@https:--en.wikipedia.org-w)
attribute         value
---------------   -----------------------------------------------------------------------------------------------------------------
AbsolutePath      https://en.wikipedia.org/w/api.php?action=query&titles=SQL&format=xml&prop=description
Characterset      ISO-8859-1
Connection        https:--en.wikipedia.org-w
Count             1
DataUri           https://en.wikipedia.org/w/api.php?action=query&titles=SQL&format=xml&prop=description@https:--en.wikipedia.org-w
LogicalName       api
Md5               b61936451e935f25c7683ede9b26801b
Name              api.php
Parent            w
Path              https://en.wikipedia.org/w/api.php?action=query&titles=SQL&format=xml&prop=description
Sha384            a27590cd933c93a9fd7dda31e0d20d5fab3ee0b952f6382c4d615d732df64347523e5368d007c6d4076a3d494b050acf
Sha384Integrity   sha384-onWQzZM8k6n9fdox4NINX6s+4LlS9jgsTWFdcy32Q0dSPlNo0AfG1AdqPUlLBQrP
Size              -1
Type              application/xml
</console>
</unit>