新 getentry ヘルプ

新 getentry の機能について

  • 新 getentry では,アクセッション番号からの DDBJ フラットファイルの検索にご利用いただけます。
  • 新 getentry は webAPI として実装しており,簡単な web フォームから利用するだけでなく,プログラムなどから直接呼び出すことが可能です。
  • データの変更履歴 検索機能 が,webAPI プログラムの "gethistory" として新規に追加されました。
  • 従来の getentry にあった "DDBJ フラットファイルのキーワード検索" は 新 ARSA で利用することが可能です。

入力フォームによる検索

http://getentry.ddbj.nig.ac.jp/top-j.html からご利用下さい。

 

WebAPI プログラムと URL

新 getentry の web API は以下の2つのプログラムからなります。

getentry アクセッション番号(データベース中のエントリの ID)を与えると,データを返します。
gethistory
(この機能は新設)
アクセッション番号(データベース中のエントリの ID)を与えると,データの変更履歴を返します。

*特許庁由来アミノ酸配列の更新履歴は今のところとっておりません。

パラメータの指定方法

以下の2種類があります。

通常の GET method http://getentry.ddbj.nig.ac.jp/getentry?database=データベース名&accession_number=アクセッション番号&追加のパラメーター(任意)
smart URL http://getentry.ddbj.nig.ac.jp/getentry/データベース名/アクセッション番号

http://getentry.ddbj.nig.ac.jp/getentry/データベース名/アクセッション番号/?追加のパラメーター(任意)

http://getentry.ddbj.nig.ac.jp/getentry/データベース名/アクセッション番号/リビジョン ID /?追加のパラメーター(任意)

(例)
通常の GET method によるアクセッション番号 FW383979 の検索
http://getentry.ddbj.nig.ac.jp/getentry?database=ddbj&accession_number=FW383979
smart URL による特許庁由来アミノ酸配列 BD500001 の検索
http://getentry.ddbj.nig.ac.jp/getentry/patent_aa/BD500001

指定可能なパラメータについて

getentry

  • accession 番号(必須): 検索対象の Accession 番号を指定します。
  • database(任意): 検索対象のデータベースを指定します。
  • revision(任意): 指定された revision 時点を検索します。
  • format(任意): 結果の出力フォーマットを指定します。
  • filetype(任意): 出力のファイルタイプを指定します。
  • show_suppressed(任意): suppressed または replaced のデータを表示します。
  • limit(任意): データの取得上限を設定します。


accession 番号(必須): 検索対象の Accession 番号を指定します。

バージョン番号 ついていない場合は,最新バージョンを検索します。
ついている場合は,指定のバージョンを検索します。
複数 Accession 番号
  • ","区切りで複数の Accession 番号を指定できます。
  • ","区切りで複数指定された場合,指定の順で出力されます。
  • 二つの Accession 番号"-"で連結することにより範囲検索ができます。
  • 範囲指定や複数指定ではバージョン番号を指定しても無視されます。
範囲指定 範囲指定の両端の Accession 番号は前方のみの不完全でも構いません。
範囲指定も","区切りで複数指定できます。
範囲指定や複数指定ではバージョン番号を指定しても無視されます。
対象の Accession 番号が存在しない,または表示できない場合,該当の Accession 番号に対する結果は何も表示されず,limit で上限が制限されているときの数にもカウントされません。
デフォルトでの表示件数が10件に設定されているため,それ以上の件数を指定する場合には "limit" で設定を解除して下さい。
(入力例)
アクセッション番号 FW383979 の検索
http://getentry.ddbj.nig.ac.jp/getentry/ddbj/FW383979
特許庁由来アミノ酸配列の検索
http://getentry.ddbj.nig.ac.jp/getentry/patent_aa/BD500001
複数アクセッション番号の検索
http://getentry.ddbj.nig.ac.jp/getentry/ddbj/AK388128,AK388131,AK388124,AK388126
複数アクセッション番号の検索(範囲指定)
http://getentry.ddbj.nig.ac.jp/getentry/ddbj/FY782538-FY831121
100件表示させたい場合
http://getentry.ddbj.nig.ac.jp/getentry/ddbj/AK377185 - AK377195,AK388063 - AK388065, AK388077 - AK388079,AK388100 - AK388104,AK388126?limit=100

 
 


database(任意): 検索対象のデータベースを指定します。

指定なし ddbj
DNA 系 ddbj, wgs, mga
Protein 系 uniprot, acc_dad, pid_dad, patent_aa, pdb
ddbj (デフォルト)を指定すると,tpa のエントリも取得対象となります。
※ DDBJ release に TPA は含まれておりません。
(入力例)
WGS( BAET01000001) の検索
http://getentry.ddbj.nig.ac.jp/getentry/wgs/BAET01000001
特許庁由来アミノ酸配列の検索
http://getentry.ddbj.nig.ac.jp/getentry/patent_aa/DI500001
DAD の検索
http://getentry.ddbj.nig.ac.jp/getentry/dad/AB000714-1
UniProt の検索
http://getentry.ddbj.nig.ac.jp/getentry/uniprot/P06213

 
 


revision(任意): 指定された revision 時点を検索します。

通常 yyyy-MM-dd hh:mm:ss
リリース時 yyyy-MM-dd hh:mm:ss release
バージョン番号と revision が同時に指定されているとき,revision が優先さます。


format(任意): 結果の出力フォーマットを指定します。

指定なし flatfile
flatfile 平文で出力します
xml XML 形式に変換して出力します
fasta [DNA 系] 全塩基配列 FASTA
[Protein 系] アミノ酸配列 FASTA
trans [DNA 系] CDS アミノ酸 FASTA
cds [DNA 系] CDS 塩基配列 FASTA
[DAD 限定] 塩基配列 FASTA (for DAD)
(入力例)
指定なし
http://getentry.ddbj.nig.ac.jp/getentry/ddbj/FW383979
特許庁由来アミノ酸配列の検索結果を アミノ酸配列FASTA 形式 で表示
http://getentry.ddbj.nig.ac.jp/getentry/patent_aa/BD500001?format=fasta
>BD500001|JP 2000316586-A/3: Recombinant microorganism expressing small rubber particle-bound protein (SRPP).
MAEEVEEERLKYLDFVRAAGVYAVDSFSTLYLYAKDISGPLKPGVDTIENVVKTVVTPVY
YIPLEAVKFVDKTVDVSVTSLDGVVPPVIKQVSAQTYSVAQDAPRIVLDVASSVFNTGVQ
EGAKALYANLEPKAEQYAVITWRALNKLPLVPQVANVVVPTAVYFSEKYNDVVRGTTEQG
YRVSSYLPLLPTEKITKVFGDEAS
塩基配列 FASTA 形式で表示
http://getentry.ddbj.nig.ac.jp/getentry/ddbj/FW383979?format=fasta
>FW383979|FW383979.1 JP 2006521812-A/1: GENETIC POLYMORPHISMS ASSOCIATED WITH RHEUMATOID ARTHRITIS, METHODS OF DETECTION AND USES THEREOF.
aagacttcctggaagaggtcccagcgtgagtgtcgcttctggcatctgtccttctggcca
gcctgtggtctggccaagtgatgtaaccctcctctccagcctgtgcacaggcagcctggg
aacagctccatccccacccctcagctataaatagggcmtygtgacccggccrggggaaga
agctgcygttgttctgggtactacagcagaagggtatgcrgaagcsagcaccccagtctg
agatggctcctgccggtgtgagcctgagggccaccatcctctgcctcctggcctgggctg
gcctggctgcaggtgaccgggtgtacatacaccccttccacytcgtcatccacaatgaga
gtaccygtgagyagctggcaaaggccaatgccgggaagcccaaagaccccaccttcatac
ctgctccaattcaggccaagacatcccctgtggatgaaaaggccctacaggaccagctgg
----(以下略)----

 
 


filetype(任意): 出力のファイルタイプを指定します。

指定なし text
html HTMLファイル
text テキストファイル
gz gz圧縮ファイル
gz圧縮ファイルのファイル名はformatの指定値によって以下のようになります。
[DNA系]flatfile flatfile.txt.gz
[DNA系]xml insd.xml.gz
[DNA系]fasta fasta_na.txt.gz
[DNA系]trans cds_aa.txt.gz
[DNA系]cds cds_na.txt.gz
[Protein系]flatfile flatfile.txt.gz
[Protein系]fasta fasta_aa.txt.gz
[Protein系]cds cds_na.txt.gz
(入力例)
AK377185-AK378194(1000エントリ)を gzファイルでダウンロード
http://getentry.ddbj.nig.ac.jp/getentry/ddbj/AK377185-AK378194?filetype=gz

パソコン上に上記のような画面が表示されます。

 
 


show_suppressed (任意): suppressed データを表示します。

true suppressed データを表示
(入力例)
アクセッション番号 HE602933 (suppressed)の検索
http://getentry.ddbj.nig.ac.jp/getentry/ddbj/HE602933?show_suppressed=true

 
 


limit(任意): データの取得上限を設定します。

指定なし 10件
0以下の数字を指定 無制限
(入力例)
アクセッション番号 FY736910 - FY762881( 25,972 entries)の検索
http://getentry.ddbj.nig.ac.jp/getentry/ddbj/FY736910 - FY762881?limit=0

件数が多い場合,表示に時間がかかる場合があります。また,ブラウザの性能により,全件表示できない場合があります。

 
 

gethistory

  • accession 番号(必須):検索対象のAccession番号を指定します。
  • database(任意): 検索対象のデータベースを指定します。
  • revision(任意): 指定されたrevision時点を検索します。
  • filetype(任意): 出力のファイルタイプを指定します。


accession 番号(必須):検索対象のAccession番号を指定します。

指定方法は getentry と同じです。

(入力例)
アクセッション番号 AB628096 の履歴検索
http://getentry.ddbj.nig.ac.jp/gethistory/ddbj/AB628096
AB628096
2012-02-24 07:17:46 1 2012-02-24 07:17:46 live ff/DDBJ/daily/ddbj/ddbjnew/rel.88/DDBJNEWr88.087.dat.gz
2011-11-25 11:27:22 release 1 2011-11-25 11:27:22 release live ff/DDBJ/release/rel.88/ddbjvrl1.seq.gz

特許庁由来アミノ酸配列の履歴はありません

 

 

database(任意):検索対象のデータベースを指定します。

指定なし ddbj
DNA 系 ddbj, wgs

指定したデータベースが履歴管理に対応していない場合は,空の結果を返します。


type(必須):表示する履歴のタイプを指定します。

指定なし "state" になります
revision 「通常」の履歴情報
state 「詳細表示」
(入力例)
アクセッション番号 AB628096 の履歴検索(通常の履歴情報)
http://getentry.ddbj.nig.ac.jp/gethistory/ddbj/ AB628096?type=revision
AB628096
2012-02-24 07:17:46 1 live ff/DDBJ/daily/ddbj/ddbjnew/rel.88/DDBJNEWr88.087.dat.gz
2011-11-25 11:27:22 release 1 live ff/DDBJ/release/rel.88/ddbjvrl1.seq.gz

 

 
filetype(任意): 出力のファイルタイプを指定します。

指定なし text
html HTMLファイル
text テキストファイル

 

 

DDBJ エントリへのリンク設定方法

DDBJ の個々のエントリに対して,以下の方法でリンクを設定することができます。

http://getentry.ddbj.nig.ac.jp/getentry?database=データベース名&accession_number=アクセッション番号&追加のパラメーター(任意)
http://getentry.ddbj.nig.ac.jp/getentry/データベース名/アクセッション番号
http://getentry.ddbj.nig.ac.jp/getentry/データベース名/アクセッション番号/?追加のパラメーター(任意)

例えば,アクセッション番号が AB000001 であるエントリに対する URL は

http://getentry.ddbj.nig.ac.jp/getentry/ddbj/AB000001

アクセッション番号が BD500001 である特許庁由来アミノ酸配列のエントリに対する URL は,

http://getentry.ddbj.nig.ac.jp/getentry/patent_aa/BD500001

です。これを指定すると,該当のエントリが表示されます。試しに次のアクセッション番号をクリックしてみて下さい。

 
DRA へのリンク設定方法は,上記の方法とは異なりますので,DRA のホームページをご参照下さい。

ご自身のホームページを作成される場合に,この URL をご活用下さい。

2012.3.16