odbc_tables
(PHP 4, PHP 5, PHP 7, PHP 8)
odbc_tables — Belli bir veri kaynağında bulunan tablo isimlerini döndürür
Açıklama
odbc_tables(
resource $odbc
,
?string $katalog
= null
,
?string $şema
= null
,
?string $tablo
= null
,
?string $türler
= null
): resource|false
katalog
, şema
,
tablo
ve türler
bağımsız değişkenleri ile seçim şöyle yapılır:
-
katalog
tek bir yüzde iminden (%) ibaretse
ve, şema
ve tablo
birer
boş dizgeyse sonuç, veri kaynağındaki geçerli niteleyicileri içerir.
(TABLE_QUALIFIER sütunu dışında tüm sütunlar null
içerir.)
-
şema
tek bir yüzde iminden (%) ibaretse ve,
katalog
ve tablo
birer
boş dizgeyse sonuç, veri kaynağındaki geçerli sahipleri içerir.
(TABLE_OWNER sütunu dışında tüm sütunlar null
içerir.)
-
tablo_türü
tek bir yüzde iminden (%) ibaretse ve,
katalog
, şema
ve
tablo
birer boş dizgeyse sonuç, veri kaynağındaki
geçerli tablo türlerini içerir. (TABLE_TYPE sütunu dışında tüm sütunlar
null
içerir.)
Bağımsız Değişkenler
-
odbc
-
ODBC
bağlantı tanıtıcısı; ayrıntılar için odbc_connect()
işlevine bakınız.
-
katalog
-
Katalog (ODBC 2 argosunda 'qualifier' ).
-
şema
-
Şema (ODBC 2 argosunda 'owner'). Arama şablonları belirtilebilir (sıfır veya
daha fazla karakterle eşleşmek üzere "%" ve tek bir karakterle eşleşmek
üzere "_".
-
tablo
-
İsim. Arama şablonları belirtilebilir (sıfır veya
daha fazla karakterle eşleşmek üzere "%" ve tek bir karakterle eşleşmek
üzere "_".
-
türler
-
türler
boş bir dizge değilse tablo
türlerinden oluşan virgül ayraçlı bir liste olmalıdır. Her değer ya
tek tırnaklar (') arasına alınmalı ya da hiç tırnak içine
alınmamalıdır. Örnek: 'TABLE','VIEW'
veya
TABLE, VIEW
. Eğer veri kaynağı belirtilen tablo
türlerini desteklemiyorsa, işlev, bu tablo türlerinde hiçbir sonuç
döndürmez.
Dönen Değerler
İstenen bilgiyi içeren bir ODBC sonuç tanıtıcısı, başarısızlık durumunda false
döner.
Sonuç kümesi şu sütunlardan oluşur:
TABLE_CAT
TABLE_SCHEM
TABLE_NAME
TABLE_TYPE
REMARKS
Drivers can report additional columns.
Sonuç kümesi TABLE_TYPE
, TABLE_CAT
,
TABLE_SCHEM
ve TABLE_NAME
sütunlarına göre sıralanır.
Örnekler
Örnek 1 - Katalogdaki tabloların listesi
<?php
$conn = odbc_connect($dsn, $user, $pass);
$tables = odbc_tables($conn, 'SalesOrders', 'dbo', '%', 'TABLE');
while (($row = odbc_fetch_array($tables))) {
print_r($row);
break;
}
?>
Yukarıdaki örnek şuna benzer bir çıktı üretir:
Array
(
[TABLE_CAT] => SalesOrders
[TABLE_SCHEM] => dbo
[TABLE_NAME] => Orders
[TABLE_TYPE] => TABLE
[REMARKS] =>
)